home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo454.arc / COMMO.DOC < prev    next >
Text File  |  1991-05-27  |  180KB  |  4,866 lines
  1.  
  2.  
  3.  
  4.                                    ____________
  5.  
  6.                                    {COMMO} (tm)
  7.                                    ____________
  8.  
  9.  
  10.                       "A New Standard in Telecommunications"
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                         by
  18.  
  19.                                   Fred P. Brucker
  20.  
  21.                                Post Office Box 9103
  22.                                Santa Rosa, CA 95405
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                              User Guide and Reference
  30.  
  31.  
  32.  
  33.  
  34.                                    Release 4.54
  35.  
  36.                                    May 20, 1991
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.  See the file LICENSES for
  48.        additional licensing and distribution details.
  49.  
  50.        The author does not guarantee this program to be free from defects
  51.        and may not be held responsible for loss caused by such.  Your use
  52.        of this program constitutes your acceptance of these terms.
  53.  
  54.  
  55.  
  56.  
  57.            (C)Copyright 1989,1991  Fred P. Brucker  All Rights Reserved
  58.  
  59.  
  60.  
  61.                    {COMMO} (tm)  User Guide and Reference           page ii
  62.  
  63.  
  64.        ========================
  65.        Registration Information
  66.        ========================
  67.  
  68.        {COMMO} is not a public domain program and is not free.  It is
  69.        classified as "SHAREWARE."  What this means is that you may use the
  70.        program for 30 days to determine its suitability to your
  71.        application.  If after that time you decide to continue using
  72.        {COMMO} you must pay the registration fee.
  73.  
  74.        {COMMO} is a unique program and represents a great deal of work.  A
  75.        lot of functionality has been compressed into a small package, and
  76.        more features are being added on a continuing basis.  If you find
  77.        {COMMO} useful and enjoyable, you can help support future
  78.        improvements by registering your copy.
  79.  
  80.  
  81.        A single-user license is $25.00.  A diskette containing the current
  82.        release (specify 5.25" or 3.5") will be provided for a $5.00
  83.        handling fee.  Send a check or money order (US funds) to the address
  84.        below.
  85.  
  86.        Details and a multi-user (site) license fee schedule are provided in
  87.        the file REGISTER.FRM.
  88.  
  89.        See also the enclosed file LICENSES for complete licensing,
  90.        distribution and copyright information.
  91.  
  92.        My (voice) telephone number for inquiries and support for registered
  93.        users is (707) 573-1065.  Please restrict calls to business hours
  94.        (Pacific time).
  95.  
  96.         
  97.        Thank you, and I hope you enjoy {COMMO}.
  98.  
  99.  
  100.                                              Fred P. Brucker
  101.                                              P.O. Box 9103
  102.                                              Santa Rosa, CA 95405
  103.  
  104.  
  105.  
  106.                    {COMMO} (tm)  User Guide and Reference          page iii
  107.  
  108.  
  109.        ========
  110.        Contents
  111.        ========
  112.  
  113.  
  114.           Preface . . . . . . . . . . . . . . . . . . . . . . . . . . .   v
  115.  
  116.           Principal Features  . . . . . . . . . . . . . . . . . . . . .   1
  117.                The Best Way to Learn {COMMO} Quickly  . . . . . . . . .   3
  118.  
  119.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   3
  120.                Quick Start Instructions . . . . . . . . . . . . . . . .   3
  121.                Preparing Your System  . . . . . . . . . . . . . . . . .   5
  122.                Command Line Options . . . . . . . . . . . . . . . . . .   6
  123.                {COMMO} Support Files  . . . . . . . . . . . . . . . . .   8
  124.                Saving the Support Files . . . . . . . . . . . . . . . .   8
  125.                Initialization Procedure . . . . . . . . . . . . . . . .   9
  126.                Terminal Screen  . . . . . . . . . . . . . . . . . . . .   9
  127.  
  128.           {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . .  10
  129.                [Alt-A]   ASCII Upload . . . . . . . . . . . . . . . . .  10
  130.                [Alt-B]   Send Break Signal  . . . . . . . . . . . . . .  12
  131.                [Alt-C]   Clear Screen . . . . . . . . . . . . . . . . .  12
  132.                [Alt-D]   Dialing Directory  . . . . . . . . . . . . . .  12
  133.                     Dialing Directory Entry Example . . . . . . . . . .  12
  134.                [Alt-G]   Configuration File . . . . . . . . . . . . . .  15
  135.                     Explanation of items  . . . . . . . . . . . . . . .  15
  136.                [Alt-H]   How to Use Online Help . . . . . . . . . . . .  25
  137.                     Modifying the Help File . . . . . . . . . . . . . .  25
  138.                [Alt-I]   Screen Image Save  . . . . . . . . . . . . . .  26
  139.                [Alt-K]   Scrollback . . . . . . . . . . . . . . . . . .  26
  140.                [Alt-L]   Set Terminal Parameters  . . . . . . . . . . .  27
  141.                     Parameter Descriptions  . . . . . . . . . . . . . .  27
  142.                     Setting Terminal Parameters . . . . . . . . . . . .  29
  143.                [Alt-M]   Macro Processor  . . . . . . . . . . . . . . .  30
  144.                [Alt-O]   Send Modem Initialization String . . . . . . .  30
  145.                [Alt-P]   Send Current Password  . . . . . . . . . . . .  30
  146.                [Alt-Q]   Quit Call (hang up)  . . . . . . . . . . . . .  30
  147.                [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . .  31
  148.                [Alt-U]   Multi Number Dialing . . . . . . . . . . . . .  31
  149.                [Alt-X]   Exit from {COMMO}  . . . . . . . . . . . . . .  31
  150.                [Alt-1]   Capture File Options . . . . . . . . . . . . .  32
  151.                [Alt-2]   Print Log Toggle . . . . . . . . . . . . . . .  33
  152.                [Alt-3]   Sound Control Toggle . . . . . . . . . . . . .  33
  153.                [Alt-4]   AutoBaud Toggle  . . . . . . . . . . . . . . .  33
  154.                [Alt-5]   Local Echo Toggle  . . . . . . . . . . . . . .  34
  155.                [Alt-0]   Signal Lights Toggle . . . . . . . . . . . . .  34
  156.                [Alt--]   Chat Mode Toggle  (Alt minus)  . . . . . . . .  35
  157.                [Alt-=]   Doorway Mode Toggle  . . . . . . . . . . . . .  35
  158.  
  159.           Uploading / Downloading . . . . . . . . . . . . . . . . . . .  36
  160.                {COMMO} Auto Receive . . . . . . . . . . . . . . . . . .  37
  161.  
  162.  
  163.  
  164.                    {COMMO} (tm)  User Guide and Reference           page iv
  165.  
  166.  
  167.  
  168.           Programming {COMMO} Macros  . . . . . . . . . . . . . . . . .  39
  169.                Macro-id and Function Summary  . . . . . . . . . . . . .  40
  170.                Additional Macro File Rules  . . . . . . . . . . . . . .  41
  171.                Executing Macros . . . . . . . . . . . . . . . . . . . .  41
  172.                Additional Macro Execution Rules . . . . . . . . . . . .  42
  173.                Cancelling a Macro . . . . . . . . . . . . . . . . . . .  42
  174.  
  175.           {COMMO} Macro Functions . . . . . . . . . . . . . . . . . . .  43
  176.                Function Arguments . . . . . . . . . . . . . . . . . . .  43
  177.                Description of Functions (alphabetical)  . . . . . . . .  43
  178.                Table of {COMMO} Key-id's  . . . . . . . . . . . . . . .  68
  179.                Enhanced Keyboard Key-id's . . . . . . . . . . . . . . .  69
  180.  
  181.           Appendix A   Setting Up Your Modem  . . . . . . . . . . . . .  69
  182.                Answering a call from another computer . . . . . . . . .  71
  183.                Connecting two computers (null modem cable)  . . . . . .  72
  184.  
  185.           Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . .  72
  186.                DESQview . . . . . . . . . . . . . . . . . . . . . . . .  72
  187.                OmniView . . . . . . . . . . . . . . . . . . . . . . . .  74
  188.                DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . .  74
  189.  
  190.           Appendix C   Flow Control . . . . . . . . . . . . . . . . . .  75
  191.  
  192.           Appendix D   ASCII Character Representation . . . . . . . . .  76
  193.  
  194.           Appendix E   Terminal Emulation . . . . . . . . . . . . . . .  77
  195.                Printer Support  . . . . . . . . . . . . . . . . . . . .  78
  196.                ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . .  78
  197.                VT102 Keyboard Simulation  . . . . . . . . . . . . . . .  79
  198.  
  199.           Appendix F   Error Message Explanations . . . . . . . . . . .  80
  200.  
  201.  
  202.  
  203.                    {COMMO} (tm)  User Guide and Reference           page v
  204.  
  205.  
  206.        =======
  207.        Preface
  208.        =======
  209.  
  210.        {COMMO} is a general purpose telecommunications program, also called
  211.        a "terminal" program.  Use it to dial remote systems and to
  212.        communicate using a choice of terminal emulations.  Many features
  213.        are available to enhance your communications needs.
  214.  
  215.        Other than the ability to transfer ASCII text files, {COMMO} has no
  216.        internal file transfer protocols.  Instead it provides you with
  217.        powerful tools to execute external programs which specialize in
  218.        transferring files using protocols such as Zmodem, Ymodem, Xmodem,
  219.        MPt, etc.
  220.  
  221.        {COMMO} will run on any PC compatible computer with at least 128k of
  222.        memory and one diskette drive.  A serial port or internal modem with
  223.        an 8250, 16450 or 16550 series UART chip is required.
  224.  
  225.        {COMMO} can be configured to work with virtually any type of modem
  226.        that supports asynchronous communications.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.        LIST is a product of Vernon D. Buerg
  242.        DESQview is a trademark of Quarterdeck Office Systems
  243.        OmniView is a trademark of Sunny Hill Software
  244.        DoubleDOS is a trademark of SoftLogic Solutions, Inc.
  245.        DSZ is a product of Omen Technology Inc.
  246.        AutoDownload is a trademark of Omen Technology Inc.
  247.        MPt is a product of Matthew Thomas
  248.  
  249.  
  250.  
  251.                    {COMMO} (tm)  User Guide and Reference           page 1
  252.  
  253.  
  254.        ==================
  255.        Principal Features
  256.        ==================
  257.  
  258.        {COMMO} is small in size, loads rapidly and performs all functions
  259.        with great speed.
  260.  
  261.        The powerful Macro Processor allows you to:
  262.  
  263.           1)   write macro "scripts" to automate many common operations
  264.                such as logins, reading messages, uploading/downloading. 
  265.                You can sit back and watch {COMMO} do the work -- or you can
  266.                let {COMMO} perform these tasks in the middle of the night
  267.                while you sleep.
  268.  
  269.           2)   assign Function Keys, Alt Keys, Keypad Keys, etc., to:
  270.  
  271.                     (a) send a string to the modem
  272.                     (b) execute any DOS command
  273.                     (c) start any macro
  274.                     (d) initiate any {COMMO} function.
  275.  
  276.           3)   edit all macros without exiting {COMMO}, using the Internal
  277.                Editor.  
  278.  
  279.        The free-form Dialing Directory has space for hundreds of entries. 
  280.        Multi Number Dialing is supported from the command line.  AutoBaud
  281.        detect adjusts to the speed of the connection.  A Macro may be
  282.        linked to each directory entry.
  283.  
  284.        Multi-tasking support.  {COMMO} is DESQview aware, operates in as
  285.        little as 50k of memory and will execute with DSZ in a 120k DV
  286.        window (depending on support file sizes).  Also supports OmniView,
  287.        DoubleDOS and others.
  288.  
  289.        Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  290.        functions, scrolling region, graphics character set, tab set/clear,
  291.        printing, modes, reports, etc.  Complete auto-switching VT102
  292.        keyboard support via Macro Processor.
  293.  
  294.        ASCII Upload to send messages and text files.  Features line pacing
  295.        and blank line expansion.
  296.  
  297.        The Configuration File, Dialing Directory and Macro File may be
  298.        edited with full-function Internal Editor.  String search is
  299.        available in all file windows.  Most features are fully
  300.        configurable.
  301.  
  302.        {COMMO} supports all display text modes, including 132 column
  303.        screens.
  304.  
  305.  
  306.  
  307.                    {COMMO} (tm)  User Guide and Reference           page 2
  308.  
  309.  
  310.        Split-screen Chat Mode for communicating with another computer which
  311.        is also running a terminal program.  All program features are
  312.        available while in Chat Mode.
  313.  
  314.        Doorway Mode lets you operate remote applications with full use of
  315.        your screen and keyboard.
  316.  
  317.        {COMMO}'s Auto Receive feature lets you configure any four strings
  318.        to automatically trigger any four macros.  Thus any protocol with a
  319.        "signature" can be set to start automatically.  Zmodem and MPt are
  320.        two examples that are pre-configured.
  321.  
  322.        Support for any four serial ports.  Port addresses and IRQ's are
  323.        configurable.  Port speeds up to 115,200 bps (hardware dependent). 
  324.        Support for NS16550A (or AF) buffered UART chip.
  325.  
  326.        Serial port signal lights may be displayed on the status line,
  327.        including send and receive.  Very useful with internal modems.
  328.  
  329.        Scrollback buffer up to 64k bytes gives instant replay of the text
  330.        that has scrolled off the screen.
  331.  
  332.        Capture Log saves all text from the screen to a disk file.  Three
  333.        different capture modes are available.
  334.  
  335.        Screen Image Save writes the current screen to a disk file.
  336.  
  337.        Print Log writes all text from the screen to the printer.
  338.  
  339.        Usage Log records date, time, length of call and other information
  340.        about each call.  Date of last call can be saved in the Dialing
  341.        Directory.
  342.  
  343.        Support for visually impaired users, including optional BIOS
  344.        Terminal Screen writes and special sounds when errors occur.
  345.  
  346.        Enhanced keyboard support.
  347.  
  348.        Extensive context-related Online Help.
  349.  
  350.  
  351.        And {COMMO} is elegant, easy to learn and fun to use!
  352.  
  353.  
  354.  
  355.                    {COMMO} (tm)  User Guide and Reference           page 3
  356.  
  357.  
  358.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  359.                     -------------------------------------
  360.                     The Best Way to Learn {COMMO} Quickly
  361.                     -------------------------------------
  362.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  363.  
  364.  
  365.        1) Read the section "Getting Started" which will get you up and
  366.           running.
  367.  
  368.        2) Read Appendix A "Setting Up Your Modem" for some very important
  369.           instructions regarding your specific hardware.
  370.  
  371.        3) Read through the section "{COMMO} Key Commands" to familiarize
  372.           yourself with {COMMO}'s commands and features.
  373.  
  374.        4) Use Online Help as a reference while you use {COMMO}.
  375.  
  376.  
  377.        How is it pronounced???  Just like "comma" (,) except for the last
  378.        letter.  It's technical jargon for "communications."
  379.  
  380.  
  381.        ===============
  382.        Getting Started
  383.        ===============
  384.  
  385.        NOTE:  Refer to Appendix F for explanations of any error messages
  386.        you receive during your initial use of {COMMO}.
  387.  
  388.        See the following section "Preparing Your System" for more details
  389.        on getting started.
  390.  
  391.  
  392.        Quick Start Instructions
  393.        ========================
  394.  
  395.        1) If you are going to upload or download files you will need an
  396.           additional program called a "protocol driver."  See the section
  397.           "Uploading / Downloading" for details on obtaining and installing
  398.           protocol drivers.
  399.  
  400.           IMPORTANT!  {COMMO}'s Auto Receive feature is set up to to
  401.           automatically start the program DSZ.COM (from Omen Technology)
  402.           when the remote system sends a file using the Zmodem protocol.
  403.  
  404.           Do not request a file for downloading until you have this program
  405.           installed in a directory in your DOS path or in the current
  406.           directory.  If "Bad command or filename" comes up, just keep
  407.           pressing Ctrl-X until it stops.  This message means you haven't
  408.           installed DSZ properly.
  409.  
  410.  
  411.  
  412.                    {COMMO} (tm)  User Guide and Reference           page 4
  413.  
  414.  
  415.           The same applies to MPT.COM if you are using the MPt protocol.
  416.  
  417.        2) If you have a hard drive, create a subdirectory named "COMMO." 
  418.           Copy all of the files from the {COMMO} archive or distribution
  419.           diskette into this subdirectory.
  420.  
  421.           If your system has only floppy drives, copy the {COMMO} files to
  422.           a formatted diskette.
  423.  
  424.           Now change to the {COMMO} subdirectory or log in to the diskette
  425.           with the {COMMO} files.
  426.  
  427.           From the DOS prompt type "commo<cr>".
  428.  
  429.        3) When {COMMO} asks, "Initialize modem?," answer "yes" (make sure
  430.           your modem is turned on first).  Now you will be in the Terminal
  431.           Screen (with the Status Line at the bottom).
  432.  
  433.           Press Alt-G to bring up the Configuration (setup) File.  You will
  434.           be in {COMMO}'s Internal Editor and you may change any portion of
  435.           the file using the arrow keys, PgUp, PgDn and other editing keys. 
  436.           Press Alt-E for Edit Help to see a list of editing keys.
  437.  
  438.           You may need to change some of the items to conform to your
  439.           system setup.  Notice that {COMMO} uses only the items that are
  440.           contained in curly braces: { }.  All other text is treated as
  441.           commentary and not used by the program.
  442.  
  443.           Most items will not need to be changed until you are more
  444.           familiar with {COMMO}.  For now, check the following:
  445.  
  446.                The Serial Port Parameters in the first item.  Make sure you
  447.                have the correct port # (the third field).  If your modem is
  448.                on COM2, change it to "2", COM3 to "3", etc.
  449.  
  450.                The items under "Paths and Files" (page down to see these). 
  451.                If your hard drive or diskette are different from the
  452.                examples, make the necessary adjustments.
  453.  
  454.           Press [Esc] to return to the Terminal Screen.
  455.  
  456.        4) Press Alt-D to enter the Dialing Directory.  An entry may be
  457.           dialed by positioning the Selector Bar and pressing [Enter]. 
  458.           {COMMO} will automatically dial the number and retry if it is
  459.           busy.
  460.  
  461.           To alter an entry or to add new ones, just press [E] to enter
  462.           edit mode.  This is the same Internal Editor you used to modify
  463.           the Configuration File.  When you are finished making changes,
  464.           press [Esc] to bring back the Selector Bar.
  465.  
  466.  
  467.  
  468.                    {COMMO} (tm)  User Guide and Reference           page 5
  469.  
  470.  
  471.        5) When a connection is made with a remote system, {COMMO} will
  472.           return to the Terminal Screen where you may interact with the
  473.           remote.
  474.  
  475.           NOTE:  If your modem does not seem to operate properly (no
  476.           connection is made or the data is garbled), read Appendix A
  477.           "Setting Up Your Modem."  You may need to change the Modem
  478.           Initialization String in the Configuration File.  If you change
  479.           it, press Alt-O (letter "O") after returning to the Terminal
  480.           Screen and {COMMO} will send the string to the modem.  Then try
  481.           dialing again.
  482.  
  483.  
  484.        Preparing Your System
  485.        =====================
  486.  
  487.        The following sections give startup instructions in greater detail.
  488.  
  489.        Make sure that all of the files from the {COMMO} package are in one
  490.        directory or on one diskette.  Four of these files are required to
  491.        run the {COMMO} program:
  492.  
  493.             COMMO.COM      the Program File
  494.             COMMO.CFG      the Configuration File
  495.             COMMO.FON      the Dialing Directory File
  496.             COMMO.MAC      the Macro File
  497.  
  498.        In addition, if Online Help is used (recommended):
  499.  
  500.             COMMO.HLP      the Online Help File
  501.  
  502.        There are two ways to make sure that {COMMO} will be able to find
  503.        all of its files.  The first method is the simplest and should be
  504.        used if you are not too familiar with DOS commands:
  505.  
  506.        1) Make sure you are logged into the directory or disk drive where
  507.           the files are located.  Then simply type "commo" at the DOS
  508.           prompt.  If your files are in the directory "C:\COMMO" you would
  509.           type:
  510.  
  511.                c:<cr>
  512.                cd \commo<cr>
  513.                commo<cr>
  514.  
  515.           (<cr> is the [Enter] or Return key)
  516.  
  517.           Or if the files are on a diskette in drive A you would type:
  518.  
  519.                a:<cr>
  520.                commo<cr>
  521.  
  522.  
  523.  
  524.                    {COMMO} (tm)  User Guide and Reference           page 6
  525.  
  526.  
  527.           {COMMO} will remember where the files are, so you will be able to
  528.           change directory or drive later without concern.
  529.  
  530.        2) The second method is a little more advanced, but allows you to
  531.           run {COMMO} no matter what directory or drive you are currently
  532.           logged into:
  533.  
  534.           Use the SET command in DOS to store the {COMMO} path into the
  535.           "environment."  If you place this command in your AUTOEXEC.BAT
  536.           file you won't have to change directories or diskettes to run
  537.           {COMMO}.  If your files are in the directory "C:\COMMO" the
  538.           command would be:
  539.  
  540.                set commo=c:\commo
  541.  
  542.           If the files are on the diskette in drive B the command would be:
  543.  
  544.                set commo=b:
  545.  
  546.           Do not use any extra spaces in the SET command.  And remember to
  547.           place the {COMMO} directory or drive in your PATH command.
  548.  
  549.           IMPORTANT!  Be sure to check your "set commo=" command if you
  550.           install {COMMO} into a different directory or onto another drive
  551.           (or if you install a later release of the program).  If it points
  552.           to the wrong directory, {COMMO} will not operate properly.  This
  553.           is a common error and can cause a lot of head scratching.
  554.  
  555.  
  556.        Command Line Options
  557.        ====================
  558.  
  559.           _______________
  560.  
  561.           Dialing Strings
  562.           _______________
  563.  
  564.        Dialing Strings are used to indicate numbers to dial at program
  565.        startup.  If present, they must be placed before any command line
  566.        switches.  {COMMO} will search the Dialing Directory for each string
  567.        and mark the first entry where a match is found (case is ignored).
  568.  
  569.        The strings may consist of any part of a Dialing Directory entry
  570.        line (usually part of the system name) and may be separated by
  571.        commas or spaces.  The following characters may not appear in a
  572.        command line Dialing String: space, comma, slash (/).
  573.  
  574.        After entries in the Dialing Directory are marked, Multi Number
  575.        Dialing of the marked systems will begin.
  576.  
  577.        Examples:
  578.  
  579.  
  580.  
  581.                    {COMMO} (tm)  User Guide and Reference           page 7
  582.  
  583.  
  584.                 commo telegodzilla joes-bbs 4567 
  585.  
  586.                 commo zilla,joes,4567
  587.  
  588.        IMPORTANT!  The Modem Initialization String will normally be sent
  589.        before dialing begins.  Your modem should be turned on and ready to
  590.        receive the command string before you start {COMMO}.
  591.  
  592.           ________
  593.  
  594.           Switches
  595.           ________
  596.  
  597.        Case is ignored and the switches may be in any order (Dialing
  598.        Strings must precede them, however).  The alternate forms without
  599.        the "=" must be used if switches are to be passed as batch file
  600.        parameters ("=" acts as a delimiter on the command line).
  601.  
  602.  
  603.          /C=filename or /Cfilename      default:  COMMO.CFG
  604.  
  605.        Alternate Configuration File.  The alternate file must reside in the
  606.        {COMMO} home directory.
  607.  
  608.  
  609.          /M=macro-id or /Mmacro-id      default:  none
  610.  
  611.        Startup Macro.  The "macro-id" is a three character macro
  612.        identifier.  If the macro is found in the Macro File it will be
  613.        started.  If the macro is not found the switch will be ignored.
  614.  
  615.        The Modem Initialization String will be sent before starting the
  616.        macro unless the switch "/I=no" is present on the command line. 
  617.  
  618.  
  619.          /I=[yes/no] or /I[yes/no]      default:  none
  620.  
  621.        This switch may be used to inhibit the Modem Initialization when
  622.        Dialing Strings and/or a Startup Macro are present: "/I=no."
  623.  
  624.        It may also be used to bypass the question "Initialize modem?" on
  625.        the Initialization Screen: "/I=yes" or "/I=no."
  626.  
  627.  
  628.        Example:
  629.  
  630.                  commo joes zilla /c=other.cfg /m=abc
  631.  
  632.        Two systems will be marked in the Dialing Directory.  The alternate
  633.        Configuration File "other.cfg" will be used (it must be located in
  634.        the {COMMO} home directory).  The macro "abc" will be started if it
  635.        exists in the Macro File.
  636.  
  637.  
  638.  
  639.                    {COMMO} (tm)  User Guide and Reference           page 8
  640.  
  641.  
  642.  
  643.  
  644.        {COMMO} Support Files
  645.        =====================
  646.  
  647.        The {COMMO} files are standard ASCII text files and may be modified
  648.        with any editor (or word processor in "non-document" mode).  In
  649.        addition all but the Online Help File may be edited with {COMMO}'s
  650.        Internal Editor.
  651.  
  652.        Key definitions for the Internal Editor are given in Online Help.  A
  653.        Color Chart will be displayed in the editor when F10 is pressed
  654.        (useful in the Configuration File and for the DISPlay function in
  655.        the Macro File).
  656.  
  657.        NOTE: {COMMO} generally retains the files in memory during program
  658.        operation.  If you use an external editor to modify them while in
  659.        the Shell to DOS (or using the EXEC macro function), your changes
  660.        could be lost.  See "Saving the Support Files" below.
  661.  
  662.        Following is a brief description of each file. 
  663.  
  664.        1) COMMO.CFG.  The Configuration File contains settings for many
  665.           important parameters.  The first time you run {COMMO} you should
  666.           use the Alt-G key command to edit this file to your own needs. 
  667.           See "Alt-G  Configuration File" for details on each item.
  668.  
  669.        2) COMMO.FON.  The Dialing Directory File.  This file contains
  670.           information about the systems you will be calling, including the
  671.           telephone numbers, passwords, Linked Macro and serial port
  672.           parameters.  Use the Alt-D key command to dial numbers and to
  673.           edit this file.  Details are given in the section "Alt-D  Dialing
  674.           Directory."
  675.  
  676.        3) COMMO.MAC.  The Macro File.  Use the Alt-M key command to select
  677.           a macro for execution and to edit this file.  A complete
  678.           description of {COMMO} macros is given in the section
  679.           "Programming {COMMO} Macros" in this document.  A summary of
  680.           macro functions and key designators is also given in Online Help.
  681.  
  682.        4) COMMO.HLP.  The Online Help File.  This file contains the
  683.           information for {COMMO}'s context-related Online Help.  See "How
  684.           to Use Online Help" later in this document.
  685.  
  686.  
  687.        Saving the Support Files
  688.        ========================
  689.  
  690.        Whenever a change is made to any support file (by {COMMO} or by  
  691.        you), the internal change flag is set for that file.  Changed files
  692.        will automatically be saved to disk whenever necessary, usually when
  693.        you exit the program.
  694.  
  695.  
  696.  
  697.                    {COMMO} (tm)  User Guide and Reference           page 9
  698.  
  699.  
  700.  
  701.        You may press Alt-F in the Internal Editor to immediately save any
  702.        file.
  703.  
  704.        If you do not wish to save your changes to the Dialing Directory or
  705.        Macro File, you may press Alt-Q while in the Internal Editor.  This
  706.        will reset {COMMO}'s change flag and the file will not be saved when
  707.        exiting the program.  Any subsequent changes to the file will set
  708.        the change flag again.
  709.  
  710.  
  711.        Initialization Procedure
  712.        ========================
  713.  
  714.        When {COMMO} begins running it will process the Configuration File. 
  715.        Then it will attempt to load into memory:
  716.  
  717.           (1) the Dialing Directory     COMMO.FON
  718.           (2) the Macro File            COMMO.MAC
  719.  
  720.        Any problems encountered will be reported.  These problems must be
  721.        corrected before restarting the program.
  722.  
  723.        Automatic modem initialization will occur if Dialing Strings are
  724.        present (and matches are found), or if the Startup Macro Switch is
  725.        present (see "Command Line Options").
  726.  
  727.        Otherwise you will be asked if you want to initialize your modem. 
  728.        Answer "yes" unless you are already on line (or not using a modem).
  729.  
  730.        Please note that {COMMO} does NOT change the video display mode. 
  731.        Instead {COMMO} can adapt to any text mode that is set when the
  732.        program is started.  Check the items under "Video and Chat Mode" in
  733.        the Configuration File for details.  See also the section "[Alt-G] 
  734.        Configuration File" later in this document.
  735.  
  736.        If the display does not look right try executing the DOS command 
  737.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  738.  
  739.  
  740.        Terminal Screen
  741.        ===============
  742.  
  743.        The Terminal Screen allows you to see the characters coming in from
  744.        the serial port.  Any characters that you type will be sent out to
  745.        the serial port.  If you are connected to another system you will be
  746.        interacting with that system.
  747.  
  748.        Keep in mind that you will also be interacting with {COMMO} and with
  749.        your own computer via key commands (Alt keys, for example).  These
  750.        key commands have no effect on the remote system unless they cause
  751.  
  752.  
  753.  
  754.                    {COMMO} (tm)  User Guide and Reference           page 10
  755.  
  756.  
  757.        characters to be sent to the serial port (pressing Alt-P to send
  758.        your password, for example).
  759.  
  760.  
  761.        ====================
  762.        {COMMO} Key Commands
  763.        ====================
  764.  
  765.        The Alt Keys shown in this section are the built-in default key
  766.        assignments for the various {COMMO} commands.  Once you are familiar
  767.        with these commands you may use the Macro Processor to reassign any
  768.        of the keys.
  769.  
  770.        Keys used within the various command windows are properly detailed
  771.        in Online Help.  Please press Alt-H from any command window to
  772.        invoke {COMMO}'s context-related help system.
  773.  
  774.        Note that certain features are only available as macro functions. 
  775.        Read the section "Programming {COMMO} Macros" for details.
  776.  
  777.  
  778.        ======================
  779.        [Alt-A]   ASCII Upload
  780.        ======================
  781.  
  782.        This command is used to send prepared messages or any text files to
  783.        the remote system.  Enter the pathname of the file you wish to send.
  784.  
  785.        There is no special error checking associated with ASCII Upload.  It
  786.        is intended primarily for sending message responses and other short
  787.        text files.  For longer files, binary files or compressed files
  788.        (.ARC, .ZIP) you will want to use error checking protocols such as
  789.        Zmodem or MPt.  See "Uploading / Downloading."
  790.  
  791.        A number of parameters are used to control an ASCII Upload:
  792.  
  793.           ___________
  794.  
  795.           Line Pacing
  796.           ___________
  797.  
  798.        IMPORTANT!  Line Pacing is used to keep transmitted data
  799.        synchronized with received (echoed) data and is normally used ONLY
  800.        when the remote is sending a prompt for each line, usually "nn:" or
  801.        "nn?".  "nn" is a line number and ":" or "?" is the prompt or
  802.        "pacing character."
  803.  
  804.        {COMMO} will wait up to 5 seconds for the pacing character, then
  805.        send the next line.  If there is a 5 second delay between the
  806.        sending of each line, then either you have the wrong pacing
  807.        character or you don't need line pacing (you don't need it when
  808.        using a full-screen editor, for example).
  809.  
  810.  
  811.  
  812.                    {COMMO} (tm)  User Guide and Reference           page 11
  813.  
  814.  
  815.  
  816.        At any time, the Spacebar may be pressed to force transmission of
  817.        the next line.  This is very useful when you have set the wrong
  818.        pacing character or if you wish to send each line manually.  In the
  819.        latter case, use any pacing character that is different from the one
  820.        in the line prompt.
  821.  
  822.        To use line pacing, enter the pacing character when {COMMO} asks for
  823.        it in the ASCII Upload window.  
  824.  
  825.        The initial pacing character is configurable.  See "[Alt-G] 
  826.        Configuration File."
  827.  
  828.        The pacing character may be any character including control
  829.        characters, e.g. "^m" or "|" for carriage return.  See Appendix D
  830.        for details on how to represent special characters.
  831.  
  832.        See also Appendix C "Flow Control."
  833.  
  834.           ________________
  835.  
  836.           Character Pacing
  837.           ________________
  838.  
  839.        You may insert a delay between each character using the Inter-
  840.        Character Delay feature.  This should only be used when the remote
  841.        is so slow that characters are dropped.  See "Set Terminal
  842.        Parameters" for details.
  843.  
  844.           ___________________
  845.  
  846.           Stripping Linefeeds
  847.           ___________________
  848.  
  849.        Normally you will want to strip linefeeds from your outgoing text. 
  850.        This will appear to the remote as if you are typing the data.  But
  851.        if all your data displays on the same line at the remote, then you
  852.        must configure {COMMO} to send the linefeeds.
  853.  
  854.        Note: This is a Configuration File item.
  855.  
  856.           _____________________
  857.  
  858.           Expanding Blank Lines
  859.           _____________________
  860.  
  861.        You may configure {COMMO} to send a space character whenever a blank
  862.        line is encountered in the text file you are sending.  This will
  863.        prevent your message from terminating prematurely if you are sending
  864.        to a BBS message editor.  Blank line expansion is not normally
  865.        required when sending to a "full screen" BBS editor.
  866.  
  867.  
  868.  
  869.                    {COMMO} (tm)  User Guide and Reference           page 12
  870.  
  871.  
  872.        Note: This is a Configuration File item.
  873.  
  874.  
  875.        ===========================
  876.        [Alt-B]   Send Break Signal
  877.        ===========================
  878.  
  879.        A one second Break Signal will be sent.  This signal is used by some
  880.        systems to interrupt certain operations.  Use it only when the
  881.        remote system directs you to do so.
  882.  
  883.  
  884.        ======================
  885.        [Alt-C]   Clear Screen
  886.        ======================
  887.  
  888.        The Terminal Screen will be cleared and the current colors will be
  889.        set to the Configuration File defaults.
  890.  
  891.  
  892.        ===========================
  893.        [Alt-D]   Dialing Directory
  894.        ===========================
  895.  
  896.        The Dialing Directory is your data base of telephone numbers.  From
  897.        the directory window you can select numbers to dial and also update
  898.        the directory using the Internal Editor.
  899.  
  900.        Refer to Online Help for a complete description of the commands
  901.        available in the Dialing Directory window.
  902.  
  903.        _______________________________
  904.  
  905.        Dialing Directory Entry Example
  906.        _______________________________
  907.  
  908.  
  909.          System       Telephone    System    Linked   Serial Port   Last
  910.          Name         Number       Password  Macro    Parameters    Called
  911.        _____________  __________  _________   _____  ____________  ________
  912.  
  913.        File City BBS  {555-1234}  {aardvark}  {abc}  {2400,8n1,1}  05/20/90
  914.  
  915.  
  916.        IMPORTANT!  Items in curly braces must be present (they are
  917.        positional).  Items which are not used must have a null string {} as
  918.        a placeholder.  You may omit null strings at the end of the line.
  919.  
  920.        Directory entries are limited to one per line.  Lines may be up to
  921.        255 characters in length ({COMMO}'s Internal Editor will scroll
  922.        horizontally to follow the cursor).
  923.  
  924.  
  925.  
  926.                    {COMMO} (tm)  User Guide and Reference           page 13
  927.  
  928.  
  929.        Comments may be placed anywhere outside the curly braces or on
  930.        separate lines.
  931.  
  932.        ______________________________
  933.  
  934.        System Name      File City BBS
  935.        ______________________________
  936.  
  937.           Up to 40 characters in length,  it must NOT be enclosed in curly
  938.           braces.  The System Name will be displayed on the Status Line
  939.           after connection, unless the Signal Lights option is selected. 
  940.           It will also be part of a Usage Log entry if the log is enabled.
  941.  
  942.        ______________________________________
  943.  
  944.        Telephone Number      {1-707-555-1234}
  945.        ______________________________________
  946.  
  947.           Spaces and hyphens are ignored by most modems.  The Dialing
  948.           Prefix, Telephone Number and Dialing Suffix are used to form a
  949.           dialing command.  Refer to your modem manual for details on
  950.           dialing commands.
  951.  
  952.           The Dialing Prefix may be chosen from a list of four in the
  953.           Configuration File and is indicated by #1,#2,#3 or #4.  The
  954.           prefix code must appear right after the left curly brace:
  955.  
  956.                {#2 1-707-555-1234}     Use prefix 2
  957.  
  958.           Dialing Prefix 1 is the default if none is specified.
  959.  
  960.           The Telephone Number is limited to 40 characters, excluding any
  961.           prefix code.
  962.  
  963.        _________________________________
  964.  
  965.        System Password      {mypassword}
  966.        _________________________________
  967.  
  968.           A different Password String may be defined for each system that
  969.           you call.  Passwords may be up to 64 characters in length.
  970.  
  971.           The Password String may be sent using Alt-P or by using the #
  972.           symbol in a SEND macro function.
  973.  
  974.           Passwords are invisible in the Dialing Directory window, but
  975.           appear when you enter [E]dit mode.
  976.  
  977.           Rules for writing passwords are in Appendix D.
  978.  
  979.  
  980.  
  981.                    {COMMO} (tm)  User Guide and Reference           page 14
  982.  
  983.  
  984.        _______________________
  985.  
  986.        Linked Macro      {abc}  
  987.        _______________________
  988.  
  989.           If a valid Linked Macro is specified, it will be started (as a
  990.           GOTO) when a connection is established with the remote system. 
  991.           If no macro is specified (or the macro-id is invalid), {COMMO}
  992.           will enter the Terminal Screen.
  993.  
  994.        ________________________________________
  995.  
  996.        Serial Port Parameters      {2400,8n1,1}
  997.        ________________________________________
  998.  
  999.           {Speed,Format,Comport}
  1000.  
  1001.           This item allows you to override the default settings for the
  1002.           current call.  Include only the parameters that are different
  1003.           from the settings in your Configuration File.
  1004.  
  1005.           For example you might have "{,7}", which would set the Data
  1006.           Format to "7e1", but use the default settings for the other
  1007.           parameters.
  1008.  
  1009.           See "Set Terminal Parameters" for a complete description of each
  1010.           field.  See also "AutoBaud Detect."
  1011.  
  1012.        _________________________
  1013.  
  1014.        Last Called      05/20/90
  1015.        _________________________
  1016.  
  1017.           If this item is present, {COMMO} will replace it with the current
  1018.           date whenever a connection is made with the system.  It may
  1019.           appear anywhere on the entry line (outside the curly braces). 
  1020.           Place "00/00/00" to start it.  The Dialing Directory file will be
  1021.           saved to disk when you exit {COMMO}.
  1022.  
  1023.        See also "[Alt-U]  Multi Number Dialing."
  1024.  
  1025.  
  1026.  
  1027.                    {COMMO} (tm)  User Guide and Reference           page 15
  1028.  
  1029.  
  1030.        ============================
  1031.        [Alt-G]   Configuration File
  1032.        ============================
  1033.  
  1034.        Pressing Alt-G brings up the Configuration File in edit mode (see
  1035.        "Internal Editor" in Online Help for details).
  1036.  
  1037.        The Configuration File contains settings for many parameters used by
  1038.        {COMMO}.  Some of these are "initial" or "start" values only and are
  1039.        controlled during a session with key commands.  Others (marked with
  1040.        a "*" in the sample file) may be changed for the current session
  1041.        using the Internal Editor.
  1042.  
  1043.        Each item in the Configuration File is enclosed in curly braces and
  1044.        must be present even if the contents are "null."  A null item would
  1045.        look like this: {}.  All text outside the curly braces is commentary
  1046.        and is ignored by {COMMO}.
  1047.  
  1048.        IMPORTANT!  Do not put any other curly braces in the Configuration
  1049.        File.
  1050.  
  1051.  
  1052.        Explanation of items
  1053.        ====================
  1054.  
  1055.        _________________________________________________________
  1056.  
  1057.        1 * {2400,8n1,1}
  1058.  
  1059.           Default Serial Port Parameters: {Speed,Format,Comport}
  1060.        _________________________________________________________
  1061.  
  1062.           These default values will be set at program startup and each time
  1063.           dialing begins.  Use the "Serial Port Parameters" item in the
  1064.           Dialing Directory to set overrides for the current call.  Use
  1065.           Alt-L or the macro function PARMs to set parameters at other
  1066.           times.
  1067.  
  1068.           See "Set Terminal Parameters" for a complete description of each
  1069.           field.
  1070.  
  1071.        _____________________________________________________
  1072.  
  1073.        2 * {A}    Default Terminal-Type (Ansi-bbs/Vt102/Tty)
  1074.        _____________________________________________________
  1075.  
  1076.           This default value will be set at program startup and each time
  1077.           dialing begins.  Use Alt-L or the macro function TERMinal to
  1078.           change it at other times.
  1079.  
  1080.           See "Set Terminal Parameters" for a complete description.
  1081.  
  1082.  
  1083.  
  1084.                    {COMMO} (tm)  User Guide and Reference           page 16
  1085.  
  1086.  
  1087.        ________________________________________________
  1088.  
  1089.        3 * {0}    Default Inter-Character Delay (0-999)
  1090.        ________________________________________________
  1091.  
  1092.           This default value will be set at program startup and each time
  1093.           dialing begins.  Use Alt-L or the macro function DELAy to change
  1094.           it at other times.
  1095.  
  1096.           See "Set Terminal Parameters" for a complete description.
  1097.  
  1098.        _____________________________________________
  1099.  
  1100.        4 * {no}    Drop DTR and RTS on exit (yes/no)
  1101.        _____________________________________________
  1102.  
  1103.           Leave this "no" if you want to exit {COMMO} and return while
  1104.           still connected to a host.  "Yes" will normally cause the modem
  1105.           to hang up when exiting.
  1106.  
  1107.        ______________________________________________________
  1108.  
  1109.        5 * {yes}    Software (XON/XOFF) Flow Control (yes/no)
  1110.        6 * {no}     Hardware (RTS/CTS) Flow Control (yes/no)
  1111.        ______________________________________________________
  1112.  
  1113.           These are used to control the flow of data between your computer
  1114.           and the remote system.  They prevent loss of data when one end
  1115.           can send faster than the other end can process the information. 
  1116.           See Appendix C for details.
  1117.  
  1118.        __________________________________________
  1119.  
  1120.        7 * {~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  1121.  
  1122.           Modem Init String (2400 bps and higher)
  1123.        __________________________________________
  1124.  
  1125.           This string (up to 128 characters) is normally sent to your modem
  1126.           when {COMMO} is started or when you press Alt-O.
  1127.  
  1128.           If you are using a 1200 bps modem you should remove the "&C1 &D2"
  1129.           commands.  In either case the "X" command may have to be
  1130.           adjusted.  See Appendix A "Setting Up Your Modem."
  1131.  
  1132.  
  1133.  
  1134.                    {COMMO} (tm)  User Guide and Reference           page 17
  1135.  
  1136.  
  1137.        ___________________________________________
  1138.  
  1139.         8 * {zzz,^xB00}       Auto Receive, Zmodem
  1140.         9 * {mmm,^v^h^vMPt}   Auto Receive, MPt
  1141.        10 * {}                Auto Receive
  1142.        11 * {}                Auto Receive
  1143.        ___________________________________________
  1144.  
  1145.           The general form of this item is:  {macro-id,string}.  When the
  1146.           specified string (up to 32 characters, case ignored) is received,
  1147.           the macro will be started.  These are normally used for
  1148.           automatically starting downloads, but may be used to trigger any
  1149.           macro upon receiving any string.
  1150.  
  1151.           Set the item to null {} to disable it.  Operates in Terminal Mode
  1152.           only (use GOLOok/LOOKfor in macros).
  1153.  
  1154.        ___________________________________________________
  1155.  
  1156.        12 * {}    Com1    Port address and IRQ overrides.
  1157.        13 * {}    Com2      These are normally left blank.
  1158.        14 * {}    Com3      Refer to COMMO.DOC for
  1159.        15 * {}    Com4      important details.
  1160.        ___________________________________________________
  1161.  
  1162.           Port I/O addresses and IRQ numbers are determined as follows:
  1163.  
  1164.           If there is an address in the DOS port table for the requested
  1165.           serial port, then that address will be used.  Otherwise the
  1166.           {COMMO} default address will be used.  Default base addresses and
  1167.           IRQ numbers for each port (in hex) are:
  1168.  
  1169.                Com#   Address   IRQ
  1170.  
  1171.                  1     3f8       4
  1172.                  2     2f8       3
  1173.                  3     3e8       4
  1174.                  4     2e8       3
  1175.  
  1176.           Port base address and/or IRQ no. may always be overridden.  For
  1177.           example to set Com4, port address = 238, IRQ = 5:
  1178.  
  1179.                {238,5}    Com4
  1180.  
  1181.           Your serial adapter manual may give a range of addresses, for
  1182.           example "3f8-3ff."  Use the first value as the base address.
  1183.  
  1184.           After changing these with the Internal Editor you must use Alt-L
  1185.           to re-initialize the port for the current session (just enter and
  1186.           exit the Alt-L window and {COMMO} will make the necessary
  1187.           adjustments).
  1188.  
  1189.  
  1190.  
  1191.                    {COMMO} (tm)  User Guide and Reference           page 18
  1192.  
  1193.  
  1194.        ___________________________________________________
  1195.  
  1196.        16   {no}    Start with AutoBaud Detect on (yes/no)
  1197.        ___________________________________________________
  1198.  
  1199.           Determines the initial state of the AutoBaud toggle.  See
  1200.           "AutoBaud Detect."
  1201.  
  1202.        ________________________________________________________________
  1203.  
  1204.        17 * {yes}    Clear dialing marks when saving directory (yes/no)
  1205.        ________________________________________________________________ 
  1206.  
  1207.           If this is "yes", dialing marks will not be written to disk when
  1208.           saving the Dialing Directory file.  Set it to "no" if you wish
  1209.           the marks to be saved with the file (to be used in the next
  1210.           session).
  1211.  
  1212.           Note that changes to dialing marks (mark or unmark) will not
  1213.           cause the file to be saved upon exit from {COMMO}.  If no other
  1214.           changes occur (such as Date Last Called), you must use Alt-F in
  1215.           the Internal Editor to save the marks.
  1216.  
  1217.        _____________________________________________
  1218.  
  1219.        18 * {45}    Dialing cycle time-out (seconds)
  1220.        _____________________________________________
  1221.  
  1222.           The maximum time to wait before hanging up and redialing.  Adjust
  1223.           if your modem needs more time to complete a call.
  1224.  
  1225.        ____________________________________________________
  1226.  
  1227.        19 * {2}    Delay between dialing attempts (seconds)
  1228.        ____________________________________________________
  1229.  
  1230.           Amount of time to wait between dialing attempts.  Adjust to give
  1231.           incoming calls a greater chance of getting through.
  1232.  
  1233.        ________________________________________________________________
  1234.  
  1235.        20 * {CONNECT}                       Dialing success response(s)
  1236.        21 * {BUSY,NO CARRIER,NO DIALTONE}   Dialing failure response(s) 
  1237.        ________________________________________________________________
  1238.  
  1239.           These response codes can be found in your modem manual.  Do not
  1240.           include the speed in the CONNECT response if you are enabling
  1241.           AutoBaud.
  1242.  
  1243.           Responses are case sensitive.  Maximum length of each response
  1244.           set is 80 characters.  There should be no null strings or extra
  1245.           spaces.
  1246.  
  1247.  
  1248.  
  1249.                    {COMMO} (tm)  User Guide and Reference           page 19
  1250.  
  1251.  
  1252.  
  1253.        _______________________________________________________
  1254.  
  1255.        22 * {ATDT}    Dial Prefix #1 (default) see Online Help
  1256.        23 * {}        Dial Prefix #2
  1257.        24 * {}        Dial Prefix #3
  1258.        25 * {}        Dial Prefix #4
  1259.        26 * {|}       Dial Suffix
  1260.        _______________________________________________________
  1261.  
  1262.           These strings (up to 32 characters each) are used to create the
  1263.           dialing command.  The prefix, telephone number and suffix will be
  1264.           strung together in that order and sent to your modem.
  1265.  
  1266.           Any one of the four prefixes may be selected in the telephone
  1267.           number string (see "Dialing Directory").  The default is #1.
  1268.  
  1269.           Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an
  1270.           outside line on a switchboard.  The suffix is usually just a
  1271.           carriage return (|).  Your modem manual has additional tips on
  1272.           dialing prefixes and suffixes.
  1273.  
  1274.        __________________________________________
  1275.  
  1276.        27 * {c:\commo}    Path to find uploads
  1277.        28 * {c:\commo}    Path to place downloads
  1278.        __________________________________________
  1279.  
  1280.           The upload path will appear in the ASCII Upload window and will
  1281.           also be substituted for "%u" in EXECute macro functions.
  1282.  
  1283.           The download path will be substituted for "%d" in EXECute macro 
  1284.           functions.
  1285.  
  1286.        ______________________________________________________________
  1287.  
  1288.        29   {c:\commo\commo.cap}    Pathname for initial Capture File
  1289.        ______________________________________________________________
  1290.  
  1291.           If a filename only (no path) is specified, the current directory
  1292.           will be used.  The Capture File pathname is substituted for "%c"
  1293.           in EXECute macro functions.  See also "Capture File Options."
  1294.  
  1295.  
  1296.  
  1297.                    {COMMO} (tm)  User Guide and Reference           page 20
  1298.  
  1299.  
  1300.        _________________________________________
  1301.  
  1302.        30   {c:\commo\commo.scn}
  1303.  
  1304.           Pathname for initial Screen Image file
  1305.        _________________________________________
  1306.  
  1307.           Information is appended to this file when you use the "Screen
  1308.           Image Save" function or when you write to a disk file in the
  1309.           "Scrollback" function.  See the sections on these functions for
  1310.           details.
  1311.  
  1312.           If a filename only (no path) is specified, the current directory
  1313.           will be used.  The pathname of an open Capture File is not
  1314.           allowed.
  1315.  
  1316.        ___________________________________________________
  1317.  
  1318.        31 * {c:\commo\commo.log}    Pathname for Usage Log
  1319.        ___________________________________________________
  1320.  
  1321.           The Usage Log keeps a record of the calls you make.  If a valid
  1322.           pathname is specified, entries will be made automatically when
  1323.           you connect to a system and when you disconnect (or exit
  1324.           {COMMO}).
  1325.  
  1326.           IMPORTANT!  In order for the log to function properly your modem
  1327.           must be set to provide "true carrier detect" (see Appendix A).
  1328.  
  1329.           Use a null pathname {} to disable the Usage Log.  The Usage Log
  1330.           should be disabled when you are connecting directly to another
  1331.           computer (with a null modem cable).
  1332.  
  1333.           Specify the same log file as your external protocol driver (e.g.,
  1334.           DSZ.LOG or MPT.LOG) and you will have a complete record of your
  1335.           calls, including upload/download statistics.
  1336.  
  1337.           If a filename only (no path) is specified, the current directory
  1338.           will be used.  The pathname of an open Capture File is not
  1339.           allowed.
  1340.  
  1341.        _________________________________________
  1342.  
  1343.        32 * {yes}    Expand blank lines (yes/no)
  1344.        33 * {yes}    Strip linefeeds (yes/no)
  1345.        34   {}       Startup pacing character
  1346.        _________________________________________
  1347.  
  1348.           See "ASCII Upload" for details on these items.
  1349.  
  1350.  
  1351.  
  1352.                    {COMMO} (tm)  User Guide and Reference           page 21
  1353.  
  1354.  
  1355.        __________________________________________________
  1356.  
  1357.        35   {no}    Default to Dialing Directory (yes/no)
  1358.        __________________________________________________
  1359.  
  1360.           If this is set to "yes" the Dialing Directory will be entered
  1361.           when {COMMO} is started.
  1362.  
  1363.        ______________________________________________
  1364.  
  1365.        36   {no}    Start with Local Echo on (yes/no)
  1366.        ______________________________________________
  1367.  
  1368.           If this is set to "yes" Local Echo will be on when {COMMO} is
  1369.           started.  See "Local Echo."
  1370.  
  1371.        _________________________________________________
  1372.  
  1373.        37   {no}    Start with Signal Lights on (yes/no)
  1374.        _________________________________________________
  1375.  
  1376.           If this is set to "yes" Signal Lights will be on when {COMMO} is
  1377.           started.  See "Signal Lights Display."
  1378.  
  1379.        __________________________________________________
  1380.  
  1381.        38   {no}    Start with Capture File open (yes/no)
  1382.        __________________________________________________
  1383.  
  1384.           If this is set to "yes" Capture will be open when {COMMO} is
  1385.           started.  See "Capture File Options."
  1386.  
  1387.        _________________________________________________________
  1388.  
  1389.        39 * {screen}    Startup Capture Mode (screen/filter/raw)
  1390.        _________________________________________________________
  1391.  
  1392.           See "Capture File Options" for a description of each mode.
  1393.  
  1394.        ________________________________________________
  1395.  
  1396.        40 * {no}    Test for enhanced keyboard (yes/no)
  1397.        ________________________________________________
  1398.  
  1399.           Set this to "yes" if your system supports the enhanced (101 key)
  1400.           keyboard.  This will enable you to assign F11, F12 and a number
  1401.           of other keys to your macros.  See "Table of {COMMO} Key-id's".
  1402.  
  1403.  
  1404.  
  1405.                    {COMMO} (tm)  User Guide and Reference           page 22
  1406.  
  1407.  
  1408.        ___________________________________________________________
  1409.  
  1410.        41 * {yes}    Display time of day with System Name (yes/no)
  1411.        ___________________________________________________________
  1412.  
  1413.           If this is "yes" only the first 30 characters of the System Name
  1414.           will be displayed on the Status Line.  The time will be displayed
  1415.           in the remaining space.  If "no" the System Name will be
  1416.           displayed in 40 characters.
  1417.  
  1418.        _________________________________________________
  1419.  
  1420.        42   {yes}    Start with Master Sound on (yes/no)
  1421.        _________________________________________________
  1422.  
  1423.           If this is set to "yes" sound will be on when {COMMO} is started. 
  1424.           See "Sound Control."
  1425.  
  1426.        _______________________________________________
  1427.  
  1428.        43 * {yes}    Dialing connection alarm (yes/no)
  1429.        _______________________________________________
  1430.  
  1431.           Controls the alarm that signals a connection when Auto Dialing is
  1432.           used.  The alarm will not be sounded if a Linked Macro is
  1433.           started.
  1434.  
  1435.        __________________________________________________
  1436.  
  1437.        44 * {yes}    ASCII Upload finished alarm (yes/no)
  1438.        __________________________________________________
  1439.  
  1440.           Controls the alarm that signals completion of an ASCII Upload.
  1441.  
  1442.        _________________________________________________
  1443.  
  1444.        45 * {3}    Maximum number of alarm rings (1-999)
  1445.        _________________________________________________
  1446.  
  1447.           Sets the number of times the alarm will ring.  You may press a
  1448.           key at any time to stop the alarm.
  1449.  
  1450.  
  1451.  
  1452.                    {COMMO} (tm)  User Guide and Reference           page 23
  1453.  
  1454.  
  1455.        _______________________________________________________
  1456.  
  1457.        46   {10}    Scrollback buffer size in kilobytes (0-64)
  1458.        _______________________________________________________
  1459.  
  1460.           The actual minimum size of the buffer (which {COMMO} will
  1461.           compute) depends on the number of screen lines and columns.  For
  1462.           a 25x80 screen it will be about 4k bytes -- it will be larger for
  1463.           screens with more lines and/or columns.  This includes room to
  1464.           save the current screen.
  1465.  
  1466.           Setting the size to 0 disables the Scrollback feature.  See
  1467.           "Scrollback" for details.
  1468.  
  1469.        _____________________________________________________________
  1470.  
  1471.        47 * {no}     Snow checking on CGA adapter (yes/no)
  1472.        48 * {no}     Use BIOS for Terminal Screen scrolling (yes/no)
  1473.        49 * {no}     Use BIOS for Terminal Screen output (yes/no) 
  1474.        _____________________________________________________________
  1475.  
  1476.           Change these video parameters only if necessary.
  1477.  
  1478.           o    Snow checking will slow the display somewhat, but will help
  1479.                to eliminate the "snow" effect on CGA monitors.
  1480.  
  1481.           o    BIOS scrolling enables external scrollback programs to work,
  1482.                but is slower and may cause "flicker" in certain displays.
  1483.  
  1484.           o    The Terminal Screen BIOS display is intended primarily for
  1485.                use with speech synthesizers (enabling blind users to read
  1486.                the computer display).  This also slows the display.
  1487.  
  1488.        ____________________________________________________________
  1489.  
  1490.        50   {no}    Auto-detect number of rows and columns (yes/no)
  1491.        ____________________________________________________________
  1492.  
  1493.           {COMMO} will support 25 to 127 rows and 80 to 255 columns on the
  1494.           display, but you MUST set the display into the proper mode before
  1495.           starting the program (EGA/VGA adapters usually come with
  1496.           utilities to set modes such as 50x80, 44x132, etc.).
  1497.  
  1498.           Set this item to "yes" if you want {COMMO} to automatically
  1499.           obtain the current number of rows and columns from the system. 
  1500.           Most systems provide this information.  If the display is
  1501.           unsatisfactory, you may have to set it to "no."
  1502.  
  1503.           Note: The cursor may not display properly in 43 line mode.  This
  1504.           is a problem with some EGA adapters.
  1505.  
  1506.  
  1507.  
  1508.                    {COMMO} (tm)  User Guide and Reference           page 24
  1509.  
  1510.  
  1511.        ______________________________________________________
  1512.  
  1513.        51 * {18}    Number of lines in upper Chat Mode window
  1514.        ______________________________________________________
  1515.  
  1516.           This allows you to adjust the line "split" in Chat Mode.  The
  1517.           minimum number of lines in the upper or lower window is three.
  1518.  
  1519.        _____________________________________________________________
  1520.  
  1521.        52 * {no}    Send when Enter is pressed in Chat Mode (yes/no)
  1522.        _____________________________________________________________
  1523.  
  1524.           If "no" {COMMO} will send each character as you type it.  If
  1525.           "yes" {COMMO} will wait until you press Enter, then send all that
  1526.           you have typed.
  1527.  
  1528.        ____________________________________________
  1529.  
  1530.        53 * {no}    Enable mono attributes (yes/no)
  1531.        ____________________________________________
  1532.  
  1533.           If this is "no" the default mono attributes will be used.  Set it
  1534.           to "yes" if you want to set your own monochrome attributes (high
  1535.           intensity, reverse video, underline, etc.).  This has no effect
  1536.           on color displays.
  1537.  
  1538.        __________________________________________________
  1539.  
  1540.        54 * {07}               Terminal Screen colors
  1541.        55 * {17}               File window text colors
  1542.        56 * {70}               File window border colors
  1543.        57 * {3f}               File window cursor colors
  1544.        58 * {70}               Small window text colors
  1545.        59 * {17}               Small window border colors
  1546.        60 * {17}               Status Line colors
  1547.        __________________________________________________
  1548.  
  1549.           Press F10 in the Configuration File window to pop up the color
  1550.           chart.  You may use it with color or monochrome displays.
  1551.  
  1552.           Note:  For the most accurate ANSI-BBS or VT102 terminal
  1553.           emulation, the Terminal Screen colors should be set to {07}.  In
  1554.           many cases, {COMMO} uses this color when clearing portions of the
  1555.           screen or when a "reset attributes" sequence is received from the
  1556.           host.
  1557.  
  1558.           "File windows" are full-screen windows such as the Dialing
  1559.           Directory, Macro File, Scrollback Buffer, etc.  "Small windows"
  1560.           are the pop up windows such as Capture File Options or ASCII
  1561.           Upload.
  1562.  
  1563.  
  1564.  
  1565.                    {COMMO} (tm)  User Guide and Reference           page 25
  1566.  
  1567.  
  1568.           Colors should be set so that the different parts of the screen
  1569.           contrast with each other.  For example the Status Line should be
  1570.           easily discernable from the rest of the Terminal Screen.  And the
  1571.           borders and Selector Bar should stand out against the text
  1572.           portion of the file windows.
  1573.  
  1574.  
  1575.        ================================
  1576.        [Alt-H]   How to Use Online Help
  1577.        ================================
  1578.  
  1579.        A summary of {COMMO}'s operations is available by pressing Alt-H. 
  1580.        The Online Help support file, COMMO.HLP, must be in the {COMMO} home
  1581.        directory or you will get an error message, "Unable to open Help
  1582.        file."
  1583.  
  1584.        This message will also be issued if there is not enough memory to
  1585.        load the Online Help file.  Note that the file is retained in memory
  1586.        until {COMMO} requires memory for some other program function.  It
  1587.        will automatically be re-read when necessary. 
  1588.  
  1589.        Once the Help window is entered you will see the Help control keys
  1590.        listed at the bottom of the screen.  At this point you may obtain
  1591.        more detailed information about using Online Help by typing "H".
  1592.  
  1593.  
  1594.        Modifying the Help File
  1595.        =======================
  1596.  
  1597.        When you are familiar with {COMMO} you may wish to reduce the size
  1598.        of the Help File.  Feel free to edit this file with an external
  1599.        editor -- you can even set up your own menu.  The search keys are
  1600.        the bars separating the topics.  The two digit number in the middle
  1601.        of the bar may be changed to create your own key.
  1602.  
  1603.        The HELP macro function enables you to assign a key to go directly
  1604.        to any topic in Online Help.  For example:
  1605.  
  1606.                {cf6} {help 12} {}
  1607.  
  1608.        will go to topic 12 when Ctrl-F6 is pressed.
  1609.  
  1610.        If you change the Help File, remember to keep a backup copy of the
  1611.        original.
  1612.  
  1613.  
  1614.  
  1615.                    {COMMO} (tm)  User Guide and Reference           page 26
  1616.  
  1617.  
  1618.        ===========================
  1619.        [Alt-I]   Screen Image Save
  1620.        ===========================
  1621.  
  1622.        The Screen Image Save is used to append all of the text currently on
  1623.        the screen to a disk file.  This is sometimes handier than
  1624.        repeatedly opening and closing the Capture File.
  1625.  
  1626.        TIPS on using Screen Image Save:
  1627.  
  1628.        1) The pathname may not be the same as the pathname of an open
  1629.           Capture File.
  1630.  
  1631.        2) If the file cannot be opened, the old pathname is retained.
  1632.  
  1633.        Note:  The current Screen Image Save file is also used to save
  1634.        blocks of text in the Scrollback feature.
  1635.  
  1636.        See also "Capture File Options" and "Scrollback."
  1637.  
  1638.  
  1639.        ====================
  1640.        [Alt-K]   Scrollback
  1641.        ====================
  1642.  
  1643.        Scrollback allows you to see what was previously on your screen. 
  1644.        Screen data is saved to a memory buffer (the size is defined in the
  1645.        Configuration File).  Set the size to 0 to disable the feature
  1646.        entirely.
  1647.  
  1648.        A number of commands are available in Scrollback:
  1649.  
  1650.        1) You may navigate as in the Online Help file -- scroll up/down,
  1651.           page up/down, beginning/end of buffer, etc.
  1652.  
  1653.        2) Use the String Search feature available in all {COMMO} file
  1654.           windows.
  1655.  
  1656.        3) Change the Screen Image Save pathname.
  1657.  
  1658.        4) Write any part of the Scrollback buffer to the current Screen
  1659.           Image Save file.
  1660.  
  1661.        5) Exit and return to the same place the next time you call
  1662.           Scrollback.
  1663.  
  1664.  
  1665.  
  1666.                    {COMMO} (tm)  User Guide and Reference           page 27
  1667.  
  1668.  
  1669.        =================================
  1670.        [Alt-L]   Set Terminal Parameters
  1671.        =================================
  1672.  
  1673.        Lets you change the current Data Rate, Data Format, Serial Port,
  1674.        Terminal Emulation Type and Inter-Character Delay.
  1675.  
  1676.        Press Alt-L to temporarily change the parameters from the Terminal
  1677.        Screen (these will be set to Configuration File defaults or Dialing
  1678.        Directory overrides when dialing begins).  Observe your changes on
  1679.        the left side of the Status Line.
  1680.  
  1681.        The Terminal Parameters affect the transmission of data to and from
  1682.        your computer.
  1683.  
  1684.  
  1685.        Parameter Descriptions
  1686.        ======================
  1687.  
  1688.           _____
  1689.  
  1690.           Speed
  1691.           _____
  1692.  
  1693.        The rate at which data travels between your computer and the remote
  1694.        system. It is specified as "bits per second" or "bps."  Allowable
  1695.        values are 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600,
  1696.        115200.  These may be abbreviated to the first two characters in
  1697.        Serial Port Parameter strings.
  1698.  
  1699.        See "AutoBaud Detect" for more information on setting the Speed.
  1700.  
  1701.           ___________
  1702.  
  1703.           Data Format
  1704.           ___________
  1705.  
  1706.        This consists of three parts.  Allowable values are:
  1707.  
  1708.           character length:   7, 8
  1709.           parity:             [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  1710.           stop-bits:          1, 2
  1711.  
  1712.        Examples:
  1713.  
  1714.           7o2       7 bit characters, odd parity, 2 stop bits
  1715.           8m1       8 bit characters, mark parity, 1 stop bit
  1716.  
  1717.        The most common formats, "8n1" and "7e1", may be abbreviated to "8"
  1718.        and "7" in parameter strings, such as:
  1719.  
  1720.           {2400,8,1}
  1721.  
  1722.  
  1723.  
  1724.                    {COMMO} (tm)  User Guide and Reference           page 28
  1725.  
  1726.  
  1727.  
  1728.           ___________
  1729.  
  1730.           Serial Port
  1731.           ___________
  1732.  
  1733.        The channel your computer uses to talk to the outside world.  May be
  1734.        1, 2, 3 or 4 (for Com1, Com2, Com3 or Com4).
  1735.  
  1736.           _______________________
  1737.  
  1738.           Terminal Emulation Type
  1739.           _______________________
  1740.  
  1741.        {COMMO} supports the following terminal types:
  1742.  
  1743.           ANSI-BBS (A)   for calling most bulletin board systems
  1744.           VT102    (V)   for calling certain mainframes and online services
  1745.           TTY      (T)   for turning off almost all control functions (lets
  1746.                          you see ANSI control sequences).
  1747.  
  1748.           _____________________
  1749.  
  1750.           Inter-Character Delay
  1751.           _____________________
  1752.  
  1753.        This factor defines the amount of delay to insert between characters
  1754.        transmitted by the SEND macro function and by ASCII Upload.  Use
  1755.        only when the remote is too slow to process the data (drops
  1756.        characters).
  1757.  
  1758.        Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT
  1759.        class machine.  Faster machines require higher values -- on a 12 MHz
  1760.        AT each unit will only be about 1 ms.
  1761.  
  1762.        For example, to delay 20 ms between characters (50 cps) use a factor
  1763.        of:
  1764.  
  1765.                 4 on 4.77 MHz XT
  1766.                16 on 12 MHz AT
  1767.                27 on 20 MHz 386
  1768.  
  1769.        The factor will also vary when you use multi-tasking software, so
  1770.        adjust as necessary.  The maximum delay allowed is one second.
  1771.  
  1772.  
  1773.  
  1774.                    {COMMO} (tm)  User Guide and Reference           page 29
  1775.  
  1776.  
  1777.        Setting Terminal Parameters
  1778.        ===========================
  1779.  
  1780.           __________________________
  1781.  
  1782.           With the Alt-L Key Command
  1783.           __________________________
  1784.  
  1785.        Alt-L may be used at any time to change parameters temporarily. 
  1786.        Remember that parameters will be reset to the Configuration File
  1787.        defaults whenever dialing begins.
  1788.  
  1789.           _________________________
  1790.  
  1791.           In the Configuration File
  1792.           _________________________
  1793.  
  1794.        Set the default items (Serial Port Parameters, Terminal-Type, Inter-
  1795.        Character Delay) to establish values that will be used at program
  1796.        startup and each time dialing begins.
  1797.  
  1798.           ________________________
  1799.  
  1800.           In the Dialing Directory
  1801.           ________________________
  1802.  
  1803.        Serial Port Parameters may be specified in a Dialing Directory entry
  1804.        to override the default settings.  Specify only values that are
  1805.        different.  For example:
  1806.  
  1807.           {,,3}     Different serial port is required for this call
  1808.  
  1809.           {,8o2}    Unusual format
  1810.  
  1811.           ________________________________________________
  1812.  
  1813.           Using the Macro functions PARMs, TERMinal, DELAy
  1814.           ________________________________________________
  1815.  
  1816.        Use these to set parameters during macro execution -- to set a
  1817.        Terminal-Type during a login macro, for example.  See "Programming
  1818.        {COMMO} Macros."
  1819.  
  1820.  
  1821.  
  1822.                    {COMMO} (tm)  User Guide and Reference           page 30
  1823.  
  1824.  
  1825.        =========================
  1826.        [Alt-M]   Macro Processor
  1827.        =========================
  1828.  
  1829.        The Macro Processor executes and maintains {COMMO} macros.  See the
  1830.        section "Programming {COMMO} Macros" which shows you how easily you
  1831.        can automate program operations, link to external protocols (for
  1832.        Uploading/Downloading), assign keys and perform a myriad of other
  1833.        functions.  The Macro File is maintained with the Internal Editor. 
  1834.  
  1835.        See Online Help for details on operations within the Macro Processor
  1836.        window.
  1837.  
  1838.  
  1839.        ==========================================
  1840.        [Alt-O]   Send Modem Initialization String
  1841.        ==========================================
  1842.  
  1843.        Pressing Alt-O at any time from the Terminal Screen will cause the
  1844.        modem initialization string to be sent to the modem.  This is useful
  1845.        if your modem was powered off or if the modem setup was changed.
  1846.  
  1847.  
  1848.        ===============================
  1849.        [Alt-P]   Send Current Password
  1850.        ===============================
  1851.  
  1852.        Each entry in the Dialing Directory can have its own Password
  1853.        String.  After dialing a number, the Alt-P key command will send the
  1854.        current Password String to the remote system.
  1855.  
  1856.        For additional details on Passwords see "Dialing Directory."
  1857.  
  1858.  
  1859.        =============================
  1860.        [Alt-Q]   Quit Call (hang up)
  1861.        =============================
  1862.  
  1863.        Quits the call by dropping DTR.  This will put the modem "on-hook"
  1864.        if response to DTR is enabled (see Appendix A).  If your modem does
  1865.        not respond properly, you may define a macro to send a "hang-up"
  1866.        command.  For modems using the "AT" command set the macro would look
  1867.        like this:
  1868.  
  1869.           {nf0} {send ~~~+++~~~ATH|} {}    Press F10 to hangup
  1870.           
  1871.        Of course, you may assign this macro to any key you like.
  1872.  
  1873.  
  1874.  
  1875.                    {COMMO} (tm)  User Guide and Reference           page 31
  1876.  
  1877.  
  1878.        ======================
  1879.        [Alt-S]   Shell to DOS
  1880.        ======================
  1881.  
  1882.        When you Shell to DOS {COMMO} remains resident in memory and you may
  1883.        perform any DOS functions as you normally do.  Since {COMMO} is
  1884.        small in size, most of your memory is available when you use this
  1885.        key command.
  1886.  
  1887.  
  1888.        ==============================
  1889.        [Alt-U]   Multi Number Dialing
  1890.        ==============================
  1891.  
  1892.        Any number of entries may be "marked" in the Dialing Directory, then
  1893.        automatically dialed in sequence until a connection is established. 
  1894.        Multi Number Dialing may be initiated in one of four ways:
  1895.  
  1896.        1) Bring up the Dialing Directory window with Alt-D, then move the
  1897.           Selector Bar to each desired entry and press [Space] (repeat the
  1898.           procedure to unmark an entry).  Press Alt-U to begin dialing at
  1899.           the location of the Selector Bar.
  1900.  
  1901.        2) Specify entries with Dialing Strings on the command line used to
  1902.           run {COMMO} (see "Command Line Options").  Specified entries will
  1903.           be marked and dialed in sequence when {COMMO} is started.
  1904.  
  1905.        3) Specify entries with Dialing Strings in a macro, using the MARK
  1906.           function (see "Programming {COMMO} Macros").
  1907.  
  1908.        4) Press Alt-U from the Terminal Screen.  Dialing of marked entries
  1909.           will resume with the next system in the sequence.
  1910.  
  1911.        See also "[Alt-D]  Dialing Directory" and the DIAL function under
  1912.        "Programming {COMMO} Macros."
  1913.  
  1914.  
  1915.        ===========================
  1916.        [Alt-X]   Exit from {COMMO}
  1917.        ===========================
  1918.  
  1919.        This key command will cause {COMMO} to terminate, saving all support
  1920.        files with outstanding changes.
  1921.  
  1922.        You may configure {COMMO} to leave DTR high when exiting so that you
  1923.        may exit and remain connected to a system (this is the default, see
  1924.        "Configuration File").  Then if you re-enter {COMMO} you would
  1925.        answer "no" to the question about initializing your modem.
  1926.  
  1927.        Alt-X may also be pressed from the Dialing Directory or Macro File
  1928.        windows for a quick exit.
  1929.  
  1930.  
  1931.  
  1932.                    {COMMO} (tm)  User Guide and Reference           page 32
  1933.  
  1934.  
  1935.  
  1936.        ==============================
  1937.        [Alt-1]   Capture File Options
  1938.        ==============================
  1939.  
  1940.        When Capture is OPEN all information written to your screen will be
  1941.        saved to the designated disk file.  This command allows you to:
  1942.  
  1943.           1)   OPEN/CLOSE the Capture File.
  1944.           2)   Change to a different file.
  1945.           3)   Change the Capture Mode.
  1946.  
  1947.        Data may be captured in one of three modes.  The startup Capture
  1948.        Mode is selected in the Configuration File.
  1949.  
  1950.           If the mode is set to SCREEN, data will be captured exactly as it
  1951.           appears on the Terminal Screen.  This mode greatly improves the
  1952.           appearance of screens drawn with ANSI positioning sequences
  1953.           (animation).
  1954.  
  1955.           FILTER mode is used primarily when you need to capture lines
  1956.           longer than the width of the screen (e.g., to be printed on a
  1957.           wide carriage printer).  ANSI controls will still be stripped out
  1958.           if ANSI-BBS or VT102 emulation is on.
  1959.  
  1960.           Use RAW mode when you want all data captured exactly as it comes
  1961.           from the serial port.  ANSI control sequences will not be
  1962.           stripped and length of lines will be preserved.  This mode can be
  1963.           used to capture ANSI animation and color to be "played back"
  1964.           later.
  1965.  
  1966.        TIPS on using the Capture File:
  1967.  
  1968.        1) IMPORTANT!  When capturing to a floppy drive, the diskette should
  1969.           not be removed until the Capture File is closed (this also
  1970.           applies if the "disk full" message appears).  DOS is unaware of a
  1971.           disk change and may overwrite the replacement disk.
  1972.  
  1973.        2) The old file will be closed if a new file is opened.
  1974.  
  1975.        3) If Capture Mode is set to SCREEN, text will be saved as it
  1976.           scrolls OFF the screen.  To prevent loss of data, the entire
  1977.           screen will be saved in the following situations:
  1978.  
  1979.                (1) whenever the screen is cleared
  1980.                (2) Capture is closed with Alt-1
  1981.                (3) {COMMO} is terminated
  1982.                (4) the mode is changed from SCREEN to FILTER or RAW
  1983.  
  1984.           If Capture Mode is set to FILTER or RAW, text will be saved as it
  1985.           arrives from the serial port.
  1986.  
  1987.  
  1988.  
  1989.                    {COMMO} (tm)  User Guide and Reference           page 33
  1990.  
  1991.  
  1992.        See also "Screen Image Save."
  1993.  
  1994.  
  1995.        ==========================
  1996.        [Alt-2]   Print Log Toggle
  1997.        ==========================
  1998.  
  1999.        Turns the Print Log ON/OFF.  When ON all information written to your
  2000.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  2001.        lists, messages, etc.
  2002.  
  2003.        TIPS on using the Print Log:
  2004.  
  2005.        1) Text is printed as it scrolls OFF the screen.
  2006.  
  2007.        2) To prevent loss of data, the entire screen will be printed in the
  2008.           following situations:
  2009.  
  2010.                (1) whenever the screen is cleared
  2011.                (2) Print Log is turned off with Alt-2
  2012.                (3) {COMMO} is terminated
  2013.  
  2014.        3) Flow Control should be used if your printer cannot keep up with
  2015.           the incoming data (see Appendix C).
  2016.  
  2017.  
  2018.        ==============================
  2019.        [Alt-3]   Sound Control Toggle
  2020.        ==============================
  2021.  
  2022.        This is the Master Sound Control toggle.  When sound is OFF all
  2023.        alarms, sounds and beeps will be silenced.  Alarms are individually
  2024.        controlled with items in the Configuration File and with the "%a"
  2025.        parameter in EXECute macro functions.
  2026.  
  2027.  
  2028.        =========================
  2029.        [Alt-4]   AutoBaud Toggle
  2030.        =========================
  2031.  
  2032.        AutoBaud Detect enables {COMMO} to automatically adjust to the line
  2033.        speed of the system you are calling.  You won't have to hang up and
  2034.        call back when you get the wrong speed.
  2035.  
  2036.        TIPS on using AutoBaud:
  2037.  
  2038.        1) Your modem must be set to return the connection speed responses
  2039.           such as "CONNECT 1200" (see Appendix A "Setting Up Your Modem").
  2040.  
  2041.        2) The default serial port speed in the Configuration File should be
  2042.           set to your modem's highest speed.
  2043.  
  2044.  
  2045.  
  2046.                    {COMMO} (tm)  User Guide and Reference           page 34
  2047.  
  2048.  
  2049.           ____________________
  2050.  
  2051.           Most 2400 bps modems
  2052.           ____________________
  2053.  
  2054.        Toggle AutoBaud Detect to the ON state (uppercase "B" on the Status
  2055.        Line). Set the default speed in the Configuration File to 2400.  The
  2056.        following result-codes will cause the indicated actions:
  2057.  
  2058.           CONNECT 2400  -->  serial port remains at 2400 bps
  2059.           CONNECT 1200  -->  serial port adjusted to 1200 bps
  2060.           CONNECT       -->  serial port adjusted to 300 bps
  2061.  
  2062.           _________________
  2063.  
  2064.           High-speed modems
  2065.           _________________
  2066.  
  2067.  
  2068.        Most high-speed modems require that the serial port be "locked" at
  2069.        19200 bps or 38400 bps.  The modem will then automatically adjust to
  2070.        the line (modem-to-modem) speed.  In this case AutoBaud must be
  2071.        turned OFF to prevent {COMMO} from changing the serial port speed.
  2072.  
  2073.        Some high-speed modems may be operated such that the serial port
  2074.        must be adjusted to the speed given in the CONNECT message.  In this
  2075.        case follow the instructions for 2400 bps modems above.
  2076.  
  2077.  
  2078.        ===========================
  2079.        [Alt-5]   Local Echo Toggle
  2080.        ===========================
  2081.  
  2082.        Local Echo (sometimes called half-duplex) is normally used when you
  2083.        connect to a host that does not echo what you type.  {COMMO} will
  2084.        assume that the host is sending a linefeed with each carriage
  2085.        return.
  2086.  
  2087.        Typed characters will be displayed directly to the screen.
  2088.  
  2089.  
  2090.        ==============================
  2091.        [Alt-0]   Signal Lights Toggle
  2092.        ==============================
  2093.  
  2094.        Turns ON/OFF the "modem lights" display on the status line.  Shows
  2095.        the state of the RS-232C signals, including send and receive.
  2096.  
  2097.        This toggles the right half of the Status Line from the System Name
  2098.        to the Signal Lights Display.  See "What is on the Status Line" in
  2099.        Online Help for a complete description of the Status Line
  2100.        indicators.
  2101.  
  2102.  
  2103.  
  2104.                    {COMMO} (tm)  User Guide and Reference           page 35
  2105.  
  2106.  
  2107.  
  2108.  
  2109.        ==========================
  2110.        [Alt--]   Chat Mode Toggle  (Alt minus)
  2111.        ==========================
  2112.  
  2113.        Chat Mode is normally used when you wish to converse via keyboard.
  2114.        The screen will be split with the upper portion showing what the
  2115.        remote is sending, while the lower portion shows what you type.
  2116.  
  2117.        The method used to send typed characters is set in the Configuration
  2118.        File under the section "Video and Chat Mode."  The two possible
  2119.        methods are:
  2120.  
  2121.           1)   Each character is sent as you type it.  This method is
  2122.                normally used when you are chatting with another person who
  2123.                is also in Chat Mode.
  2124.  
  2125.           2)   All characters are sent at once when you press Enter (up to
  2126.                240 characters will be buffered).  Use this method when you
  2127.                are using a teleconferencing system or "CB Simulator."
  2128.  
  2129.        The number of lines in the upper and lower portions of the screen
  2130.        (the "line split") may also be set in the "Video and Chat Mode"
  2131.        section.
  2132.  
  2133.        TIPS on using Chat Mode:
  2134.  
  2135.        1) Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  2136.  
  2137.        2) All {COMMO} functions are available in Chat Mode except Doorway
  2138.           Mode.
  2139.  
  2140.  
  2141.        =============================
  2142.        [Alt-=]   Doorway Mode Toggle
  2143.        =============================
  2144.  
  2145.        Definition: "Extended keys" are function keys, Alt keys, cursor
  2146.        keys, etc.  In other words, keys that do not generate ASCII
  2147.        characters.
  2148.  
  2149.        In Doorway Mode all extended keys will send their key codes to the
  2150.        remote (instead of activating {COMMO} functions).  Thus Doorway Mode
  2151.        can be used to operate most application software on the remote
  2152.        system when used with a host program such as Marshall Dudley's
  2153.        Doorway.  In addition some BBS full-screen editors use Doorway Mode.
  2154.  
  2155.  
  2156.  
  2157.                    {COMMO} (tm)  User Guide and Reference           page 36
  2158.  
  2159.  
  2160.        TIPS on using Doorway Mode:
  2161.  
  2162.        1) The Alt-= key is necessarily reserved for exiting Doorway Mode
  2163.           and thus cannot be sent to the remote.  Be sure to configure
  2164.           remote applications accordingly.
  2165.  
  2166.        2) The display should be set to the number of lines expected by the
  2167.           host program.  Usually this is 25 lines of text.  If your display
  2168.           is not in the proper mode, the results will be unpredictable.
  2169.  
  2170.        3) The Status Line is normally suppressed in Doorway Mode, but may
  2171.           be turned on by using the "s" parameter in a macro:
  2172.  
  2173.                {al=} {doorway s} {}
  2174.  
  2175.           The "s" parameter is ignored when exiting Doorway Mode and the
  2176.           Status Line will be restored to its previous state.  Remember
  2177.           that when the Status Line is on, there is one less usable line on
  2178.           the Terminal Screen.
  2179.  
  2180.        4) If it is necessary to clear the screen or to reset the terminal
  2181.           emulation mode parameters when starting Doorway Mode, use a
  2182.           macro.  For example:
  2183.  
  2184.                {al=} {clear} {term a} {doorway} {}
  2185.  
  2186.           This macro will execute when entering or exiting Doorway Mode
  2187.           (Alt-= must be used to exit, but any key may be assigned to enter
  2188.           Doorway Mode).
  2189.  
  2190.        5) For most applications you will want Terminal-Type set to
  2191.           ANSI-BBS.  It's a good idea to enter Doorway Mode before starting
  2192.           the host program.  The host may send commands to initialize the
  2193.           terminal.
  2194.  
  2195.        6) If Software Flow Control is enabled, the ASCII character values
  2196.           17 and 19 (XON and XOFF) will not display.  If these characters
  2197.           are needed, Software Flow Control must be turned off.
  2198.  
  2199.  
  2200.        =======================
  2201.        Uploading / Downloading
  2202.        =======================
  2203.  
  2204.        ASCII Upload is the only file transfer protocol internal to {COMMO}.
  2205.        The Macro Processor enables you to execute external protocol
  2206.        "driver" programs easily and seamlessly.
  2207.  
  2208.        The Macro File is pre-configured with macros that execute various
  2209.        popular protocol drivers, including DSZ.COM which performs Xmodem,
  2210.        Ymodem and Zmodem uploads and downloads.  Use the Alt-M key command
  2211.        "Macro Processor" to select one of these macros.  You may add macros
  2212.  
  2213.  
  2214.  
  2215.                    {COMMO} (tm)  User Guide and Reference           page 37
  2216.  
  2217.  
  2218.        for any other protocol drivers that you need.  See "Programming
  2219.        {COMMO} Macros" for details on writing macros.
  2220.  
  2221.  
  2222.        Installing DSZ.COM
  2223.        ==================
  2224.  
  2225.        DSZ is a Shareware program from Omen Technology and is highly
  2226.        recommended for fast and reliable file transfers.  Like {COMMO} it
  2227.        must be registered for continued use.  DSZ may almost always be
  2228.        found where you obtained {COMMO} and is usually archived as
  2229.        DSZmmdd.ZIP (mmdd is a release date).
  2230.  
  2231.        To install DSZ just place DSZ.COM in a directory which is specified
  2232.        in your DOS path statement.  If you don't have a path statement in
  2233.        your AUTOEXEC.BAT file, place DSZ.COM in your C:\COMMO directory. 
  2234.        In the latter case, change to this directory before you start
  2235.        {COMMO}.
  2236.  
  2237.        MPT.EXE may be installed in a similar fashion for doing MPt
  2238.        transfers.
  2239.  
  2240.  
  2241.        {COMMO} Auto Receive
  2242.        ====================
  2243.  
  2244.        This feature will automatically start a macro when a specified
  2245.        string is received from the serial port and is normally used for
  2246.        starting downloads.
  2247.  
  2248.        Up to four strings and respective macro-id's may be defined in the
  2249.        "Terminal and Modem" section of the Configuration File.  These are
  2250.        preconfigured for the Zmodem and MPt protocol "signature" strings,
  2251.        but you may change them or add new ones as desired.
  2252.  
  2253.        As an example, suppose one of the Auto Receive strings in your
  2254.        Configuration File is:
  2255.  
  2256.                {zzz,^XB00}    Zmodem AutoDownload
  2257.  
  2258.        This means that when the string "^XB00" is received, the macro "zzz"
  2259.        will be started.  This string is the Zmodem signature string.
  2260.  
  2261.        In your Macro File you have the corresponding macro:
  2262.  
  2263.          ZMODEM BATCH  {zzz} {exec DSZ port %p rz -m %d %a%w} {}
  2264.  
  2265.        {COMMO} will execute the macro as soon as the signature string is
  2266.        received (be patient, a BBS may take several seconds to load and
  2267.        execute its own protocol program).
  2268.  
  2269.  
  2270.  
  2271.                    {COMMO} (tm)  User Guide and Reference           page 38
  2272.  
  2273.  
  2274.        IMPORTANT!  If you have not properly installed the protocol program,
  2275.        the message "Bad command or file name" will be periodically
  2276.        displayed by DOS.  If this happens type Ctrl-X repeatedly until the
  2277.        sender cancels the transfer.
  2278.  
  2279.        TIPS on using Auto Receive:
  2280.  
  2281.        1) When you are confident that Auto Receive is operating properly,
  2282.           you may remove the "%w" parameter from the macro.  {COMMO} will
  2283.           no longer wait following execution of the protocol program.  You
  2284.           may also remove the "%a" alarm parameter if desired.
  2285.  
  2286.        2) Auto Receive will not trigger on characters that are displayed to
  2287.           the screen while a macro is running.
  2288.  
  2289.        3) The serial port input buffer will be cleared following any EXEC,
  2290.           EXEN or EXED that is part of an Auto Receive macro.  This
  2291.           prevents repeated signature strings from triggering the macro
  2292.           more than once.
  2293.  
  2294.        4) If you need to download within a macro, you should do a LOOKfor
  2295.           to wait for the signature string, then CALL the download macro
  2296.           (make sure you have a RETUrn at the end).
  2297.  
  2298.        5) Using short strings, such as "^E" for CIS B protocol may result
  2299.           in unexpected triggering of the macro.  This is because other
  2300.           systems may send the same string for a different purpose (to
  2301.           display a "club" symbol, for example).  Thus it may be necessary
  2302.           to disable a string at times or to discontinue its use.
  2303.  
  2304.        6) A string may be disabled by removing the corresponding macro-id
  2305.           in the Macro File, but this degrades performance since the Macro
  2306.           File must be scanned each time a "hit" occurs.  Instead, the
  2307.           Configuration File item should be replaced with a null {}.
  2308.  
  2309.        7) Auto Receive can be set up for protocols that do not send
  2310.           signature strings, such as Xmodem, Ymodem, Ymodem-G, etc.  Use
  2311.           the prompt that the BBS sends just prior to the file transfer. 
  2312.           For example, "Start your Ymodem-G now."  Note that different
  2313.           systems may use different prompts.
  2314.  
  2315.        8) An Auto Receive string can be used to automatically continue
  2316.           Multi Number Dialing after you disconnect (in manual mode).  Set
  2317.           one of the strings to:
  2318.  
  2319.                     {ncd,^jNO CARRIER^m}
  2320.  
  2321.           Then enter a macro in the Macro File:
  2322.  
  2323.                     {ncd} {dial ,} {}
  2324.  
  2325.  
  2326.  
  2327.                    {COMMO} (tm)  User Guide and Reference           page 39
  2328.  
  2329.  
  2330.           When your modem sends "NO CARRIER" the macro will start.  Multi
  2331.           Number Dialing will resume if any more systems are marked in the
  2332.           Dialing Directory.
  2333.  
  2334.        See also "TIPS on creating LOOKfor strings" in the section
  2335.        describing the LOOKfor function.
  2336.  
  2337.  
  2338.        ==========================
  2339.        Programming {COMMO} Macros
  2340.        ==========================
  2341.  
  2342.        IMPORTANT!  Please read the next few pages before you attempt to
  2343.        write any macros!  The rules for writing {COMMO} macros are few in
  2344.        number, but must be followed carefully.  Examples of more complex
  2345.        macro programming are given in the sample Macro File, COMMO.MAC, and
  2346.        in the supplied file, MACROS.TXT.
  2347.  
  2348.        The following sections assume familiarity with {COMMO}'s key
  2349.        commands and with other features of the program.  Since many macro
  2350.        functions have corresponding key commands, duplicate explanations
  2351.        will not be given here.  Refer to the description of the key command
  2352.        in a previous section.
  2353.  
  2354.        {COMMO}'s Macro File may contain any number of macros.  The only
  2355.        size limitation on the file is that the Dialing Directory and Macro
  2356.        File combined must total 64k bytes or less.
  2357.  
  2358.        Alternate Macro Files may be loaded using the MACLoad function (the
  2359.        original file is replaced and may be reloaded at a later time). 
  2360.        Only macros within the currently loaded Macro File are active.
  2361.  
  2362.        Macros may be used to perform many different operations, yet their
  2363.        structure is simple and consistent.  Here are some examples:
  2364.  
  2365.           {alk} {clear} {stop}
  2366.  
  2367.        This macro will define Alt-K to clear the screen.  "alk" is called a
  2368.        "macro identifier" or "macro-id" for short, and is three characters
  2369.        in length.
  2370.  
  2371.        Certain macro-id's are reserved to represent keys on the keyboard,
  2372.        such as "alk" in this case, and are called "key-id's."
  2373.  
  2374.        CLEAr is called a "function" and is represented by four or more
  2375.        characters of which only the first four are necessary (shown in
  2376.        uppercase as a reminder).
  2377.  
  2378.        The STOP function is used here to terminate the macro and may be
  2379.        used in either it's long or short form:
  2380.  
  2381.  
  2382.  
  2383.                    {COMMO} (tm)  User Guide and Reference           page 40
  2384.  
  2385.  
  2386.           ... {stop}          long form
  2387.           ... {}              short form
  2388.  
  2389.        Note that the default key to clear the screen, Alt-C, is still in
  2390.        effect unless it is reassigned.
  2391.  
  2392.        All of {COMMO} key-id's and functions are described in later
  2393.        sections.  They are also summarized in Online Help.
  2394.  
  2395.           {abc}     {setlook 30,hng,3,|} {lookfor first name?}
  2396.                     {send Fred|} {return}
  2397.  
  2398.        In this macro the SETLook function will set timeout parameters for
  2399.        subsequent LOOKfor functions.  The LOOKfor will then watch the data
  2400.        coming in from the modem and when it sees "first name?", control
  2401.        will pass to the next function.  In this case the next function,
  2402.        SEND, will send the string "Fred" followed by a carriage return
  2403.        (indicated by the "|").
  2404.  
  2405.        The macro ends with a RETUrn function.  If the macro was CALLed from
  2406.        another macro, control will return to the CALLing macro.  Otherwise
  2407.        the RETUrn will behave like a STOP.
  2408.  
  2409.           {bbs}     {capture y,commo.cap} {call abc}
  2410.                     {asciiup textfile.xyz,:} {}
  2411.  
  2412.        This macro will open the capture file "commo.cap" (the "y" means
  2413.        "yes", open the file).  Then it will execute the previously
  2414.        described macro "abc."  Then it will ASCII Upload the file
  2415.        "textfile.xyz" using the pacing character ":".
  2416.  
  2417.        Note that macros may occupy more than one line in the Macro File.
  2418.  
  2419.  
  2420.        Macro-id and Function Summary
  2421.        =============================
  2422.  
  2423.        MACRO-ID's must be three characters (commas and curly braces should
  2424.        not be used).  Case is ignored so that "GK1" is the same as "gk1" or
  2425.        "gK1."
  2426.  
  2427.        Macro-id's should be unique within each Macro File.  {COMMO} will
  2428.        always use the first occurrence of a duplicated macro-id.
  2429.  
  2430.        Macro-id's may appear anywhere within macros and may be the targets
  2431.        of CALL, GOTO and other functions.  Multiple macro-id's may appear
  2432.        before any function:
  2433.  
  2434.           {aln} {aly} {dial 50,abc} {}.
  2435.  
  2436.  
  2437.  
  2438.                    {COMMO} (tm)  User Guide and Reference           page 41
  2439.  
  2440.  
  2441.        FUNCTION NAMES are four or more characters and may always be
  2442.        abbreviated to the first four.  Case is ignored here as well.
  2443.  
  2444.        Remember to terminate each macro with a STOP function unless it
  2445.        already ends with a function which does not return control in line,
  2446.        such as GOTO, RETUrn, EXIT, etc.  If you don't, processing will
  2447.        continue with the next macro in your Macro File!
  2448.  
  2449.  
  2450.        Additional Macro File Rules
  2451.        ===========================
  2452.  
  2453.        The Macro File is entirely free-form.  Macro-id's and functions may
  2454.        appear on the same line or on separate lines.  More that one
  2455.        macro-id may appear on the same line:
  2456.  
  2457.           {ala} {clear} {}    {alw} {sound n} {}
  2458.  
  2459.        Note that only the first may be executed from the Macro File window
  2460.        using the Selector Bar.  Comments may appear anywhere outside the
  2461.        curly braces.
  2462.  
  2463.  
  2464.        Executing Macros
  2465.        ================
  2466.  
  2467.        Macro execution may be started in a number of ways:
  2468.  
  2469.        1) Open the Macro Processor window by pressing Alt-M.  Position the
  2470.           Selector Bar at the desired starting point and press [Enter]. 
  2471.           The Macro Processor will begin processing at the first macro-id
  2472.           or function on the line.
  2473.  
  2474.           Note:  Macros started with the Selector Bar do not need macro-
  2475.           id's and may be started at any point within the macro.
  2476.  
  2477.        2) If a macro-id is also a key-id, then you may press that key from
  2478.           the Terminal Screen.  If the same key-id appears more than once,
  2479.           the first occurrence will be used.
  2480.  
  2481.        3) The macro may be linked to a Dialing Directory entry.  In this
  2482.           case {COMMO} will GOTO the macro when a connection is established
  2483.           with that system (or CALL it, see the DIAL function).
  2484.  
  2485.        4) The macro may be specified on the command line with the switch
  2486.           "/m=".  It will be started as soon as {COMMO} has initialized
  2487.           itself.
  2488.  
  2489.        5) The macro may be an argument of another function such as CALL,
  2490.           GOTO, DIAL or SETLook (these are detailed in a later section).
  2491.  
  2492.  
  2493.  
  2494.                    {COMMO} (tm)  User Guide and Reference           page 42
  2495.  
  2496.  
  2497.        Some macro functions show their current action on the status line at
  2498.        the bottom of the screen.  In addition, a "face" character in the
  2499.        middle of the status line indicates that a macro is executing.
  2500.  
  2501.  
  2502.        Additional Macro Execution Rules
  2503.        ================================
  2504.  
  2505.        Use [Ctrl-Enter] instead of [Enter] to start a macro and {COMMO}
  2506.        will wait after preparing EXECute functions (before they are
  2507.        executed by DOS).  {COMMO} will also wait before returning to the
  2508.        Terminal Screen so that you may see any error messages from the
  2509.        executing program.
  2510.  
  2511.        ASCII keys may be typed to the serial port during LOOKfor, PAUSe and
  2512.        HOLD functions.
  2513.  
  2514.        The Macro Processor will execute functions in order until one of the
  2515.        following conditions occur:
  2516.  
  2517.        1) A CALL, GOTO, RETURn, STOP, EXIT, etc. is encountered.
  2518.  
  2519.        2) Control is transferred to an alternate macro from certain
  2520.           functions when a special condition occurs.  An example of this is
  2521.           the SETLook function.  The alternate will execute when a
  2522.           subsequent LOOKfor times out.
  2523.  
  2524.        3) A macro error occurs.  This will bring up the Macro Error window,
  2525.           indicating the location of the problem.  The macro is terminated.
  2526.  
  2527.        4) The end of the Macro File is reached.
  2528.  
  2529.  
  2530.        Cancelling a Macro
  2531.        ==================
  2532.  
  2533.        The [Esc] key is used to terminate macro processing.  To send an
  2534.        <esc> code to the remote (ASCII 27) during macro execution, press
  2535.        Ctrl-[ (Ctrl + left bracket).
  2536.  
  2537.        Current function execution may be terminated by pressing
  2538.        [Ctrl-Break].  For example, this can be used to terminate a LOOKfor,
  2539.        PAUSe or HOLD prematurely.  Macro processing will advance to the
  2540.        next function.
  2541.  
  2542.        If a macro contains a function that brings up a {COMMO} window
  2543.        (Dialing Directory, Capture File Options, etc.), then [Esc] will
  2544.        exit the window and processing continues with the next function.  To
  2545.        terminate macro processing from a window, press [Ctrl-Break].
  2546.  
  2547.  
  2548.  
  2549.                    {COMMO} (tm)  User Guide and Reference           page 43
  2550.  
  2551.  
  2552.        =======================
  2553.        {COMMO} Macro Functions
  2554.        =======================
  2555.  
  2556.        The purpose of this section is to show the syntax of each function
  2557.        and the meaning of its arguments through examples.  All functions
  2558.        are listed here, but details on functions which are also default key
  2559.        commands are found in the section "{COMMO} Key Commands."
  2560.  
  2561.        Function names are shown with their four-letter abbreviations in
  2562.        uppercase.  The following conventions are used in many functions:
  2563.  
  2564.           "y" or "yes" is used to indicate "yes", "on",  "open",  etc.
  2565.           "n" or "no"  is used to indicate "no",  "off", "close", etc.
  2566.  
  2567.        This provides a highly consistent macro structure which is very easy
  2568.        to remember.
  2569.  
  2570.  
  2571.        Function Arguments
  2572.        ==================
  2573.  
  2574.        Arguments are the parameters that follow the function name.  One
  2575.        space separates the function name from the arguments (extra spaces
  2576.        must be avoided).  Multiple arguments are separated by commas.  
  2577.         
  2578.           {bbs}     {capture y,commo.cap} {call abc}
  2579.                     {asciiup textfile.xyz,:} {return}
  2580.  
  2581.        Here the function CAPTure has two arguments: "y" and "commo.cap."
  2582.  
  2583.           {abc} {lookfor first name?} {send Fred|} {}
  2584.  
  2585.        The function LOOKfor has one argument: "first name?".  Quotation
  2586.        marks are NOT used to enclose data strings or filenames in {COMMO}
  2587.        macros.
  2588.  
  2589.        When a function is also associated with a default key command, the
  2590.        lack of arguments will cause the function to behave like the key
  2591.        command -- usually bringing up a window or toggling a toggle.  This
  2592.        is useful for reassigning keys.
  2593.  
  2594.  
  2595.        =======================================
  2596.        Description of Functions (alphabetical)
  2597.        =======================================
  2598.  
  2599.  
  2600.        ALARm
  2601.        -----
  2602.        Default key: none
  2603.        Description: Ring the alarm.
  2604.  
  2605.  
  2606.  
  2607.                    {COMMO} (tm)  User Guide and Reference           page 44
  2608.  
  2609.  
  2610.  
  2611.        Examples:
  2612.  
  2613.           {alarm}             Ring alarm, ring count in Config. File.
  2614.           {alarm 2}           Ring alarm 2 times.
  2615.  
  2616.        {COMMO} will wait until the alarm has stopped ringing before
  2617.        proceeding to the next macro function (the alarm may be terminated
  2618.        early by pressing a key).
  2619.  
  2620.  
  2621.        ASCIiup
  2622.        -------
  2623.        Default key: Alt-A
  2624.        Description: Upload an ASCII (text) file.
  2625.  
  2626.        General form:
  2627.  
  2628.           {ASCIiup pathname,pace}
  2629.  
  2630.                pathname       The complete path and filename (if the path
  2631.                               is absent, the current directory will be
  2632.                               used). 
  2633.  
  2634.                pace           The pacing character to be used.
  2635.  
  2636.        Examples:    
  2637.  
  2638.           {asci}                        Open ASCII Upload window.
  2639.  
  2640.           {asci c:\msgs\file.xyz,:}     Upload "file.xyz."  Use ":" for
  2641.                                         pacing.
  2642.  
  2643.           {asci c:\msgs\file.xyz}       Same, but use current pacing
  2644.                                         character.
  2645.  
  2646.           {asci c:\msgs\file.xyz,}      Same, but no pacing.
  2647.  
  2648.           {asci ,?}                     Set current pacing character to "?"
  2649.  
  2650.           {asci ,}                      Set current pacing to "no" pacing.
  2651.  
  2652.        The pacing character may be entered according to the rules in
  2653.        Appendix D "ASCII Character Representation."  For example, "^m" or
  2654.        "|" may be used to represent the carriage return.
  2655.  
  2656.  
  2657.        AUTObaud
  2658.        --------
  2659.        Default key: Alt-5
  2660.        Description: Set AutoBaud toggle.
  2661.  
  2662.  
  2663.  
  2664.                    {COMMO} (tm)  User Guide and Reference           page 45
  2665.  
  2666.  
  2667.        Examples:
  2668.  
  2669.           {auto}              Toggle AutoBaud on/off
  2670.           {auto y}            Turn on AutoBaud     
  2671.           {auto n}            Turn off AutoBaud
  2672.  
  2673.  
  2674.        BEEP
  2675.        ----
  2676.        Default key: none
  2677.        Description: Sound a beep.
  2678.  
  2679.        Example:
  2680.  
  2681.           {beep}              No arguments.
  2682.  
  2683.  
  2684.        BREAk
  2685.        -----
  2686.        Default key: Alt-B
  2687.        Description: Send a break.
  2688.  
  2689.        Example:
  2690.  
  2691.           {break}             No arguments.
  2692.  
  2693.  
  2694.        CALL
  2695.        ----
  2696.        Default key: none
  2697.        Description: Execute another macro.
  2698.  
  2699.        Example:
  2700.  
  2701.           {call abc}          Execute macro abc.
  2702.  
  2703.        If the macro "abc" executes a RETUrn function, then control returns
  2704.        to the function following the CALL.
  2705.  
  2706.        Note that macros may be nested up to 32 deep.
  2707.  
  2708.        See also RETUrn, PUSHstack, POPStack.
  2709.  
  2710.  
  2711.        CAPMode
  2712.        -------
  2713.        Default key: none
  2714.        Description: Set Capture Mode.
  2715.  
  2716.        Examples:
  2717.  
  2718.           {capmode screen}         Set Capture Mode to SCREEN.
  2719.  
  2720.  
  2721.  
  2722.                    {COMMO} (tm)  User Guide and Reference           page 46
  2723.  
  2724.  
  2725.           {capmode filter}         Set Capture Mode to FILTER.
  2726.           {capmode raw}            Set Capture Mode to RAW.
  2727.  
  2728.  
  2729.        CAPTure
  2730.        -------
  2731.        Default key: Alt-1
  2732.        Description: Capture File Options.
  2733.  
  2734.        Examples:
  2735.  
  2736.           {capture}                     Open Capture File Options window.
  2737.  
  2738.           {capture y}                   Open current Capture File.
  2739.  
  2740.           {capture n}                   Close current Capture File.
  2741.  
  2742.           {capt y,c:\commo\file.xyz}    Open indicated Capture File.
  2743.  
  2744.           {capt n,c:\dl\newfile.cap}    Close current Capture File, set new
  2745.                                         file as indicated.
  2746.  
  2747.        Note:  The current Capture File will always be closed when a new
  2748.        file is opened.
  2749.  
  2750.        See also CAPMode.
  2751.  
  2752.  
  2753.        CHATmode
  2754.        --------
  2755.        Default key: Alt-- (Alt minus)
  2756.        Description: Set Chat Mode toggle.
  2757.  
  2758.        Examples:
  2759.  
  2760.           {chat}              Toggle Chat Mode on/off.
  2761.           {chat y}            Turn on Chat Mode.
  2762.           {chat n}            Turn off Chat Mode.
  2763.  
  2764.  
  2765.        CLEAr
  2766.        -----
  2767.        Default key: Alt-C
  2768.        Description: Clear Terminal Screen to default colors.
  2769.  
  2770.        Example:
  2771.  
  2772.           {clear}             No arguments.
  2773.  
  2774.  
  2775.  
  2776.                    {COMMO} (tm)  User Guide and Reference           page 47
  2777.  
  2778.  
  2779.        CONFig
  2780.        ------
  2781.        Default key: Alt-G
  2782.        Description: Edit Configuration File.
  2783.  
  2784.        Example:
  2785.  
  2786.           {config}            No arguments.
  2787.  
  2788.  
  2789.        CURSor
  2790.        ------
  2791.        Default key: none
  2792.        Description: Terminal Screen cursor on/off.
  2793.  
  2794.        Examples:
  2795.  
  2796.           {cursor}            Toggle Terminal cursor on/off.
  2797.           {curs y}            Turn on Terminal Screen cursor.
  2798.           {curs n}            Turn off Terminal Screen cursor.
  2799.  
  2800.  
  2801.        DELAy
  2802.        -----
  2803.        Default key: none
  2804.        Description: Set Inter-Character Delay factor.
  2805.  
  2806.        Example:
  2807.  
  2808.           {delay 25}          Set factor to 25.
  2809.  
  2810.  
  2811.        DIAL
  2812.        ----
  2813.        Default keys: Alt-D, Alt-U
  2814.        Description: Dialing Directory.
  2815.  
  2816.        General form:
  2817.  
  2818.           {DIAL tries,macro-id,c}
  2819.  
  2820.                tries     The maximum number of dialing tries.  If no
  2821.                          connection is established when the try count is
  2822.                          exhausted, the macro in the second argument will
  2823.                          be started.  May be 0 to 999.  "0" means
  2824.                          unlimited.  
  2825.  
  2826.                macro-id  A macro to GOTO if the try count in the first
  2827.                          argument is exhausted.  If no macro is specified
  2828.                          or if the macro-id is invalid, control will pass
  2829.                          to the next function.
  2830.  
  2831.  
  2832.  
  2833.                    {COMMO} (tm)  User Guide and Reference           page 48
  2834.  
  2835.  
  2836.                c         Specifies that a Linked Macro (from the Dialing
  2837.                          Directory) will be entered as a CALL (instead of a
  2838.                          GOTO).  When the Linked Macro executes a RETUrn,
  2839.                          control returns to the DIAL function and Multi
  2840.                          Number Dialing will resume (see below).
  2841.  
  2842.        Default arguments are:      Dialing tries       0 (unlimited)
  2843.                                    Macro               none
  2844.                                    CALL option         no
  2845.  
  2846.        Null arguments in the DIAL function will revert to these defaults.
  2847.  
  2848.  
  2849.        Examples:
  2850.  
  2851.           {dial}              Open Dialing Directory window (like Alt-D).
  2852.  
  2853.           {dial ,}            Multi Number Dial (like Alt-U).
  2854.  
  2855.           {dial 25,abc}       Multi Number Dial with try count.
  2856.  
  2857.           {dial ,,c}          Multi Number Dial, CALL Linked Macros.
  2858.  
  2859.  
  2860.        Marked numbers will be redialed in sequence.  Numbers may be marked
  2861.        in one of several ways:
  2862.  
  2863.           1)   Manually in the Dialing Directory window.
  2864.           2)   By placing Dialing Strings on the {COMMO} command line.
  2865.           3)   Using the MARK macro function.
  2866.  
  2867.        If a connection occurs and a valid Linked Macro is specified in the
  2868.        Dialing Directory, the macro will be started (as a GOTO unless the
  2869.        "c" option is present).  If no macro is specified in the Dialing
  2870.        Directory, control is passed to the next function.
  2871.  
  2872.  
  2873.        To automatically resume Multi Number Dialing at the end of a Linked
  2874.        Macro, use one of the following methods.
  2875.  
  2876.           1)   Execute the following sequence at the end of each Linked
  2877.                Macro (or GOTO it):
  2878.  
  2879.                ... {setlook 60} {lookfor ^jNO CARRIER^m} {dial ,} {}
  2880.  
  2881.                This allows more than one system to be called without
  2882.                operator intervention.  This method will also work when
  2883.                using Dialing Strings on the command line or when pressing
  2884.                Alt-U after marking systems for dialing.
  2885.  
  2886.           2)   Use the "c" option in the DIAL function.  Each Linked Macro
  2887.                should end with a RETUrn which will transfer control back to
  2888.  
  2889.  
  2890.  
  2891.                    {COMMO} (tm)  User Guide and Reference           page 49
  2892.  
  2893.  
  2894.                the DIAL.  When all numbers have been called, the DIAL will
  2895.                pass control to the next function in sequence.
  2896.  
  2897.        See also: MARK, UNMArk.
  2898.  
  2899.  
  2900.        DISPlay
  2901.        -------
  2902.        Default key: none
  2903.        Description: Display a string to the screen.
  2904.  
  2905.        General form:
  2906.  
  2907.           {DISPlay row,col,attr,string}
  2908.  
  2909.                row       The row where the string will display.
  2910.                col       The column where the string will display.
  2911.                attr      The attribute (colors) of the string.
  2912.                string    The text of the string (no quotes).
  2913.  
  2914.        Examples:
  2915.  
  2916.           {display 12,20,17,Hello!}     Display "Hello!" at row 12, column
  2917.                                         20.  Colors are white on blue.
  2918.  
  2919.           {disp ,,,Hello, again.^m^j}   Display "Hello, again." at the
  2920.                                         current cursor using the current
  2921.                                         attribute, followed by a cr/lf.
  2922.  
  2923.           {disp 3,40}                   Position the cursor at row 3,
  2924.                                         column 40.
  2925.  
  2926.        The attribute is specified in the same manner as the colors in the
  2927.        Configuration File (press F10 in the Internal Editor to display the
  2928.        Color Chart).
  2929.  
  2930.        Setting background colors to high intensity values will cause
  2931.        blinking (for example, using "9" instead of "1" will still give a
  2932.        blue background but the foreground character will blink).  
  2933.  
  2934.        After the string is displayed, the previous Terminal Screen
  2935.        attribute will be restored.
  2936.  
  2937.  
  2938.        DOORway
  2939.        -------
  2940.        Default key: Alt-=
  2941.        Description: Toggle Doorway Mode.
  2942.  
  2943.        Example:
  2944.  
  2945.           {doorway}           Toggle Doorway Mode on/off.
  2946.  
  2947.  
  2948.  
  2949.                    {COMMO} (tm)  User Guide and Reference           page 50
  2950.  
  2951.  
  2952.           {door s}            Status Line on when entering Doorway Mode.
  2953.  
  2954.        The "s" parameter is ignored when exiting Doorway Mode (the Status
  2955.        Line will be restored to its prior state).
  2956.  
  2957.  
  2958.        EXECute
  2959.        -------
  2960.        Default key: none
  2961.        Description: Execute a DOS command.
  2962.  
  2963.        This function enables you to "build" a command to be executed by
  2964.        DOS.  The DOS command processor (COMMAND.COM) is used, which implies
  2965.        that you may specify any command as you would type it from the DOS
  2966.        prompt.  Thus you can execute batch files and internal DOS commands
  2967.        (REN, DEL, etc.).  Also you can omit command paths and extensions
  2968.        (if the command is in your PATH).
  2969.  
  2970.        A number of special parameters are available which will either
  2971.        substitute the current value of a variable or perform a specific
  2972.        action before or after command execution.
  2973.  
  2974.        In addition, the user input parameter "%i" lets you enter
  2975.        information that is not known until execution time.  For example you
  2976.        can insert a filename (or pathname) at a certain point in the
  2977.        command.
  2978.  
  2979.        The special parameters are detailed here and are also summarized in
  2980.        Online Help.  They are also used in the EXED and EXEN functions.
  2981.  
  2982.           %i   General user input prompt.  May be used more than once in a
  2983.                command and will result in a prompt for input in the
  2984.                "Execute a DOS Command" window.
  2985.  
  2986.           %p   Current serial port number (1,2,3 or 4).
  2987.  
  2988.           %s   Current serial port speed (2400, 38400, etc.).
  2989.  
  2990.           %m   Current modem speed obtained from the connect message.  For
  2991.                example, "CONNECT 2400" sets %m to "2400".  This is used to
  2992.                pass the modem speed to external protocols (for time
  2993.                estimation) when the serial port is "locked" at a higher
  2994.                speed.
  2995.  
  2996.                If your modem provides a "CARRIER" message containing the
  2997.                modem speed, then set the Dialing Success Response in the
  2998.                Configuration File to "CARRIER" instead of "CONNECT". 
  2999.  
  3000.                Note that this value is "null" when no speed is returned in
  3001.                the connect message.
  3002.  
  3003.           %u   Current upload directory (from Config File).
  3004.  
  3005.  
  3006.  
  3007.                    {COMMO} (tm)  User Guide and Reference           page 51
  3008.  
  3009.  
  3010.  
  3011.           %d   Current download directory (from Config File).
  3012.  
  3013.           %c   Current capture file (use Alt-1 to check).
  3014.  
  3015.           %k   Insert an ASCII control character into the DOS command.  For
  3016.                example to issue a formfeed to your printer you could have
  3017.                the macro function: {exec echo %k^L > prn}.  See Appendix D
  3018.                for rules on representing control characters.
  3019.  
  3020.           %a   Sound the alarm at the end of command execution.
  3021.  
  3022.           %w   Wait (pause) before restoring the Terminal Screen.  This is
  3023.                useful if you need to see the results of the command
  3024.                execution.
  3025.  
  3026.           %%   Insert an actual "%" into the command.
  3027.  
  3028.        Use [Ctrl-Enter] instead of [Enter] to start a macro and you will be
  3029.        able to see the prepared EXECute functions before they are executed
  3030.        by DOS.  {COMMO} will also wait before returning to the Terminal
  3031.        Screen so that you may see any error messages from the executing
  3032.        program.
  3033.  
  3034.  
  3035.        Examples:
  3036.  
  3037.           {exec dsz port %p speed %s sz %u\%i %a%w}
  3038.  
  3039.                {COMMO} will prepare the DSZ command by substituting the "%"
  3040.                parameters, then call DOS to execute the program.
  3041.  
  3042.                Note the "%i".  This will bring up the "Execute a DOS
  3043.                Command" window and prompt you for input (in this case, a
  3044.                filename).
  3045.  
  3046.                The alarm will sound at completion ("%a") and {COMMO} will
  3047.                wait for a keypress ("%w") before restoring the Terminal
  3048.                Screen.
  3049.  
  3050.           {exec list %c}
  3051.  
  3052.                The LIST program will be executed with the current Capture
  3053.                File as a command line argument.  {COMMO} will return
  3054.                immediately to the Terminal Screen when LIST exits.
  3055.  
  3056.  
  3057.        EXED
  3058.        ----
  3059.        Default key: none
  3060.        Description: Execute an external program directly.
  3061.  
  3062.  
  3063.  
  3064.                    {COMMO} (tm)  User Guide and Reference           page 52
  3065.  
  3066.  
  3067.        Use this function to execute .EXE and .COM programs without the use
  3068.        of the command processor (COMMAND.COM).  There are several
  3069.        advantages to this:
  3070.  
  3071.           1)   Only the memory needed to run the program must be available
  3072.                (the command processor requires that 32k or more be
  3073.                available when it is run).
  3074.  
  3075.           2)   About 4k of memory is saved by not having a copy of the
  3076.                command processor resident when the program is executed.
  3077.  
  3078.           3)   The program executes faster, since COMMAND.COM is not loaded
  3079.                from disk.
  3080.  
  3081.           4)   The program's exit code is preserved and may be tested with
  3082.                the {COMMO} IFERrorlevel function.
  3083.  
  3084.        Two important rules must be followed when using EXED:
  3085.  
  3086.           1)   The full pathname of the program file must be specified,
  3087.                including the path where the file resides on disk and the
  3088.                file extension.  For example:
  3089.  
  3090.                     {exed c:\util\list.com %c}
  3091.  
  3092.           2)   Only .EXE and .COM files may be run with EXED (batch files
  3093.                and internal DOS commands cannot be executed without the
  3094.                command processor, use EXEC or EXEN).
  3095.  
  3096.        In all other respects EXED is the same as EXECute, including the use
  3097.        of all "%" parameters.
  3098.  
  3099.  
  3100.        EXEN
  3101.        ----
  3102.        Default key: none
  3103.        Description: Execute a DOS command, do not clear the screen.
  3104.  
  3105.        This function is exactly the same as EXECute, but the Terminal
  3106.        Screen is not cleared when the command is sent to DOS.  It is used
  3107.        to produce a smoother transition when programs or DOS commands
  3108.        execute rapidly.
  3109.  
  3110.        Examples:
  3111.  
  3112.           {exen del c:\commo\commo.cap}
  3113.           {exen ren commo.cap joes-bbs.cap}
  3114.  
  3115.  
  3116.  
  3117.                    {COMMO} (tm)  User Guide and Reference           page 53
  3118.  
  3119.  
  3120.        EXIT
  3121.        ----
  3122.        Default key: Alt-X
  3123.        Description: Exit {COMMO}.
  3124.  
  3125.        Example:
  3126.  
  3127.           {exit}              No arguments (return code = 0).
  3128.           {exit 3}            With return code.
  3129.  
  3130.        The return code will be passed to DOS.  It may be tested with the IF
  3131.        ERRORLEVEL batch command.  Range is 0 to 255.
  3132.  
  3133.  
  3134.        GOLOok
  3135.        ------
  3136.        Default key: none
  3137.        Description: Set a macro-id to GOTO if a string comes in during a
  3138.                     subsequent LOOKfor function.
  3139.  
  3140.        Example construct:
  3141.  
  3142.                     {setlook 60,hng,3,n|}
  3143.                       ...
  3144.  
  3145.           {mac}     {golook aaa,string1}
  3146.                     {golook ,string2}
  3147.                     {golook bbb,string3}
  3148.                     {lookfor string4} {send answer4|} {goto ccc}
  3149.  
  3150.           {aaa}     {send answer1|} {goto mac}
  3151.           {bbb}     {call xyz} {goto mac}
  3152.  
  3153.           {ccc}       ...
  3154.  
  3155.        In this example {COMMO} will look for four strings.  When any string
  3156.        comes in, the LOOKfor is terminated (all strings are cancelled).  It
  3157.        may be set up again by going back to "mac."
  3158.  
  3159.        The GOLOok functions for string1 and string3 will GOTO "aaa" or
  3160.        "bbb" respectively if one of the strings comes in.  In the example
  3161.        control returns to "mac" and the four strings will continue to be
  3162.        looked for.
  3163.  
  3164.        The GOLOok for string2 has a null macro-id and control will pass to
  3165.        the function following the LOOKfor if the string comes in.  The ","
  3166.        must be present.
  3167.  
  3168.        If string4 comes in, control will also pass to the function
  3169.        following the LOOKfor.
  3170.  
  3171.        TIPS on using the GOLOok function:
  3172.  
  3173.  
  3174.  
  3175.                    {COMMO} (tm)  User Guide and Reference           page 54
  3176.  
  3177.  
  3178.  
  3179.        1) GOLOok functions should immediately precede a LOOKfor (no string
  3180.           compares actually occur until the LOOKfor executes).  Up to 15
  3181.           GOLOoks may be used for a total of up to 16 strings to scan for.
  3182.  
  3183.        2) If two or more strings cause a match at the same time, the LAST
  3184.           such string listed is the one acted upon.  For example, when
  3185.           "abcdef" and "def" are listed and "abcdef" comes in.
  3186.  
  3187.        3) Since the LOOKfor is terminated whenever any of the strings come
  3188.           in (or when the LOOKfor timeout expires), this structure is
  3189.           unrestricted -- that is, CALLs, GOTOs, other GOLOok/LOOKfor
  3190.           constructs, etc., may be used freely in any of the branches.
  3191.  
  3192.        4) See the PUSHstack function for an example showing how to improve
  3193.           the structure of the GOLOok/LOOKfor sequence.
  3194.  
  3195.        See also "TIPS on creating LOOKfor strings" in the section
  3196.        describing the LOOKfor function.
  3197.  
  3198.        See also: LOOKfor, SETLook, PUSHstack, POPStack.
  3199.  
  3200.  
  3201.        GOTO
  3202.        ----
  3203.        Default key: none
  3204.        Description: Transfer control to a macro-id.
  3205.  
  3206.        Example:
  3207.  
  3208.           {goto x21}          Control transferred to macro-id "x21".
  3209.  
  3210.  
  3211.        HANGup
  3212.        ------
  3213.        Default key: Alt-Q
  3214.        Description: Disconnect by dropping DTR.
  3215.  
  3216.        Examples:
  3217.  
  3218.           {hangup}            Prompt user for disconnect.
  3219.           {hangup y}          Disconnect without prompting.
  3220.  
  3221.  
  3222.        HELP
  3223.        ----
  3224.        Default key: Alt-H
  3225.        Description: Open Online Help window.
  3226.  
  3227.        Example:
  3228.  
  3229.           {help}              Display topic 00
  3230.  
  3231.  
  3232.  
  3233.                    {COMMO} (tm)  User Guide and Reference           page 55
  3234.  
  3235.  
  3236.           {help 5}            Display topic 05
  3237.  
  3238.        Topic numbers may range from 00 to 99.  You may create your own
  3239.        Online Help file.  See "Modifying the Help File."
  3240.  
  3241.  
  3242.        HOLD
  3243.        ----
  3244.        Default key: none
  3245.        Description: Hold until specified time of day (24 hour format).
  3246.  
  3247.        Examples:
  3248.  
  3249.           {hold 3:30}         Hold until 3:30 am.
  3250.           {hold 16:10}        Hold until 4:10 pm.
  3251.           {hold 0:00}         Hold until midnight.
  3252.  
  3253.        NOTE:  Incoming characters displayed during a HOLD function are not
  3254.        seen by subsequent GOLOok/LOOKfor functions.
  3255.  
  3256.  
  3257.        IFCArrier
  3258.        ---------
  3259.        Default key: none
  3260.        Description: Test for presence of carrier detect signal.
  3261.  
  3262.        General form:
  3263.  
  3264.           {IFCArrier true-id,false-id}
  3265.  
  3266.                true-id        A macro-id to GOTO if carrier is detected.
  3267.  
  3268.                false-id       A macro-id to GOTO if carrier is not
  3269.                               detected.
  3270.  
  3271.                NOTE:     The default when either macro-id is omitted is to
  3272.                          pass control to the next function.
  3273.  
  3274.        Example:
  3275.  
  3276.                {ifcarrier c10,c20}
  3277.  
  3278.        Tip on using IFCArrier:
  3279.  
  3280.           When using a loop to wait for a change in carrier detect, you
  3281.           should include a short pause in the loop if you want characters
  3282.           to display.  The following sequence will display incoming
  3283.           characters while waiting for carrier detect to drop:
  3284.  
  3285.                ... {cd1} {pause 1} {ifcarrier cd1} ...
  3286.  
  3287.  
  3288.  
  3289.                    {COMMO} (tm)  User Guide and Reference           page 56
  3290.  
  3291.  
  3292.        IFERrorlevel
  3293.        ------------
  3294.        Default key: none
  3295.        Description: Test the exit code of an EXED function.
  3296.  
  3297.        General form:
  3298.  
  3299.           {IFERrorlevel number,true-id,false-id}
  3300.  
  3301.                number         A number from 0 to 255.  It will be compared
  3302.                               to the exit code from the last EXED function.
  3303.  
  3304.                true-id        A macro-id to GOTO if the exit code is
  3305.                               greater than or equal to "number."
  3306.  
  3307.                false-id       A macro-id to GOTO if the exit code is less
  3308.                               than "number."
  3309.  
  3310.                NOTE:     The default when either macro-id is omitted is to
  3311.                          pass control to the next function.
  3312.  
  3313.        Examples:
  3314.  
  3315.                {iferror 1,abc,def}
  3316.                {iferror 5,abc}
  3317.                {ifer 2,,def}
  3318.  
  3319.        TIPS on using IFERrorlevel:
  3320.  
  3321.        1) The exit code may be tested repeatedly if necessary.
  3322.  
  3323.        2) Many programs return an exit code greater than 0 when the result
  3324.           is unsuccessful.  DSZ, for example, will return an exit code of 1
  3325.           if the file transfer has failed.
  3326.  
  3327.        3) This test is meaningful only following an EXED function.  EXEC,
  3328.           EXEN or Shell to DOS will normally set the exit code to 0.
  3329.  
  3330.  
  3331.        IFEXist
  3332.        -------
  3333.        Default key: none
  3334.        Description: Test for existence of a disk file or files.
  3335.  
  3336.        General form:
  3337.  
  3338.           {IFEXist pathname,true-id,false-id}
  3339.  
  3340.                pathname       A DOS pathname.  If the path is omitted, the
  3341.                               current directory will be used.  If wildcards
  3342.                               are used the "true" condition will hold if
  3343.                               any files match the specification.
  3344.  
  3345.  
  3346.  
  3347.                    {COMMO} (tm)  User Guide and Reference           page 57
  3348.  
  3349.  
  3350.  
  3351.                true-id        A macro-id to GOTO if the file exists.
  3352.  
  3353.                false-id       A macro-id to GOTO if no files match.
  3354.  
  3355.                NOTE:     The default when either macro-id is omitted is to
  3356.                          pass control to the next function.
  3357.  
  3358.        Examples:
  3359.  
  3360.           {ifex a:file.xyz,,m20}             GOTO "m20" if not found.
  3361.           {ifex c:\data\words.txt,345}       GOTO "345" if found.
  3362.           {ifex c:\ul\*.rep,a01,a02}         Using a wildcard.
  3363.  
  3364.  
  3365.        INITmodem
  3366.        ---------
  3367.        Default key: Alt-O
  3368.        Description: Send Modem Initialization String.
  3369.  
  3370.        Example:
  3371.  
  3372.           {init}              No arguments
  3373.  
  3374.  
  3375.        LIGHts
  3376.        ------
  3377.        Default key: Alt-0
  3378.        Description: Set Signal Lights toggle.
  3379.  
  3380.        Examples:
  3381.  
  3382.           {lights}            Toggle Signal Lights on/off.
  3383.           {lights y}          Turn on Signal Lights.
  3384.           {lights n}          Turn off Signal Lights.
  3385.  
  3386.  
  3387.        LOCAlecho
  3388.        ---------
  3389.        Default key: Alt-6
  3390.        Description: Set Local Echo toggle.
  3391.  
  3392.        Examples:
  3393.  
  3394.           {local}             Toggle Local Echo on/off.
  3395.           {local y}           Turn on Local Echo.
  3396.           {local n}           Turn off Local Echo.
  3397.  
  3398.  
  3399.  
  3400.                    {COMMO} (tm)  User Guide and Reference           page 58
  3401.  
  3402.  
  3403.        LOOKfor
  3404.        -------
  3405.        Default key: none
  3406.        Description: Look for a string in the modem input stream.
  3407.  
  3408.        Examples:
  3409.  
  3410.           {setlook 60,abc,4,n|}    Set parameters.
  3411.           {lookfor first name?}    Look for the string "first name?"
  3412.           {look ^(COMMO^)}         Look for the string "{COMMO}".
  3413.  
  3414.  
  3415.        Parameters controlling LOOKfor execution are set with the SETLook
  3416.        function, which should be executed before any LOOKfor functions. 
  3417.        See the description of the SETLook function for details.
  3418.  
  3419.        The LOOKfor function will scan for the requested string to appear,
  3420.        then macro execution will continue with the next function.
  3421.  
  3422.        Use the GOLOok function to scan simultaneously for up to 15
  3423.        additional strings during a LOOKfor.
  3424.  
  3425.        TIPS on creating LOOKfor (and GOLOok) strings:
  3426.  
  3427.        1) There should be just one space following the LOOKfor function
  3428.           name.  Any spaces beyond this point are part of the string.  The
  3429.           string ends at the right curly brace.
  3430.  
  3431.        2) GOLOok and Auto Receive strings begin after the comma following
  3432.           the macro-id.  There should be no spaces unless they are part of
  3433.           the string.
  3434.  
  3435.        3) Strings may be up to 32 characters in length (control characters
  3436.           like "^M" count as one).  Upper/lower case is ignored.
  3437.  
  3438.        4) ANSI control sequences are filtered if ANSI or VT102 emulation is
  3439.           enabled.
  3440.  
  3441.        5) Remember that short strings may not be unique enough, long
  3442.           strings may not match due to line noise.
  3443.  
  3444.        6) Rules for representing special characters in LOOKfor strings are
  3445.           given in Appendix D "ASCII Character Representation."
  3446.  
  3447.        See also: GOLOok, SETLook.
  3448.  
  3449.  
  3450.        MACLoad
  3451.        -------
  3452.        Default key: none
  3453.        Description: Load a new Macro File.
  3454.  
  3455.  
  3456.  
  3457.                    {COMMO} (tm)  User Guide and Reference           page 59
  3458.  
  3459.  
  3460.        General form:
  3461.  
  3462.           {MACLoad filename,macro-id,r}
  3463.  
  3464.                filename       The new Macro File.  Do NOT specify a path;
  3465.                               the {COMMO} home directory will be used.
  3466.  
  3467.                macro-id       A macro-id to GOTO when the new file is
  3468.                               loaded.  Optional.
  3469.  
  3470.                r              Specifies that COMMO.MAC will be reloaded 
  3471.                               when carrier detect is lost.  Normally this
  3472.                               would occur at the end of the call. 
  3473.                               Optional. 
  3474.  
  3475.        Examples:
  3476.  
  3477.           {macload vt102-1.mac,,r}      Load vt102-1.mac, reload COMMO.MAC
  3478.                                         at the end of the call.
  3479.  
  3480.           {macl newmac.fil,abc}         Load newmac.fil, start macro "abc"
  3481.                                         in the new file.
  3482.  
  3483.  
  3484.        IMPORTANT!  The new Macro File must reside in the {COMMO} home
  3485.        directory (do not specify a path).
  3486.  
  3487.        The current file will be saved to disk if changes are outstanding. 
  3488.        The new file is then loaded in place of the current one (all macros
  3489.        are replaced).  
  3490.  
  3491.        MACLoad should be the last function in a macro, since control is not
  3492.        returned.
  3493.  
  3494.  
  3495.        MACRo
  3496.        -----
  3497.        Default key: Alt-M
  3498.        Description: Open Macro Processor window.
  3499.  
  3500.        Examples:
  3501.  
  3502.           {macro}             Open window at current position.
  3503.           {macro menu1}       Open window at "menu1."
  3504.  
  3505.        NOTE:  The MACRo function always terminates the currently executing
  3506.        macro.
  3507.  
  3508.        A string argument may be included to facilitate the creation of
  3509.        menus within the Macro File.  The first occurrence of the argument
  3510.        string will become the top line of the display when the window is
  3511.        opened.
  3512.  
  3513.  
  3514.  
  3515.                    {COMMO} (tm)  User Guide and Reference           page 60
  3516.  
  3517.  
  3518.  
  3519.        The Selector Bar will be positioned on the first screen line that
  3520.        has a left curly brace, if any.
  3521.  
  3522.        TIPS on using a string argument in MACRo:
  3523.  
  3524.        1) Remember that the function itself will be included in the search.
  3525.  
  3526.        2) No character translation will be performed.  Therefore curly
  3527.           braces may not appear in the search string.
  3528.  
  3529.  
  3530.        MARK
  3531.        ----
  3532.        Default key: none
  3533.        Description: Mark Dialing Directory entries for dialing.
  3534.  
  3535.        Example:
  3536.  
  3537.           {mark joes-bbs,file-city}     Mark entries for dialing.
  3538.  
  3539.        Dialing Strings may be separated by spaces or commas.
  3540.  
  3541.        {COMMO} will search the Dialing Directory for each string and mark
  3542.        the first entry where a match is found.  Case is ignored.
  3543.  
  3544.        The strings may consist of any part of a Dialing Directory entry
  3545.        line (including passwords).  However the following characters may
  3546.        not appear in a macro Dialing String: space, comma, left or right
  3547.        curly brace. 
  3548.  
  3549.        See also: DIAL, UNMArk.
  3550.  
  3551.  
  3552.        NOOP
  3553.        ----
  3554.        Default key: none
  3555.        Description: No-op function, does nothing
  3556.  
  3557.        Example:
  3558.  
  3559.           {noop}              No arguments.
  3560.  
  3561.  
  3562.        PARMs
  3563.        -----
  3564.        Default key: Alt-L
  3565.        Description: Set Serial Port Parameters
  3566.  
  3567.        General form:
  3568.  
  3569.           {PARMs speed,format,comport}
  3570.  
  3571.  
  3572.  
  3573.                    {COMMO} (tm)  User Guide and Reference           page 61
  3574.  
  3575.  
  3576.  
  3577.                speed          The bps rate, such as 9600.
  3578.                format         The data format, such as 8n1.
  3579.                comport        The serial port number.
  3580.  
  3581.        Examples:
  3582.  
  3583.           {parms 2400,8,1}         Set 2400 bps, 8n1, Com1.
  3584.  
  3585.           {parms ,,4}              Set Com4.
  3586.  
  3587.           {parms 19200,7o1}        Set 19200 bps, 7o1.
  3588.  
  3589.        Note that omitted parameters are not changed.
  3590.  
  3591.  
  3592.        PASSword
  3593.        --------
  3594.        Default key: Alt-P
  3595.        Description: Send current password.
  3596.  
  3597.        Example:
  3598.  
  3599.           {password}          No arguments.
  3600.  
  3601.        The current password is obtained from the Dialing Directory entry
  3602.        whenever a number is dialed.  If no password is specified no
  3603.        characters will be sent.
  3604.  
  3605.  
  3606.        PAUSe
  3607.        -----
  3608.        Default key: none
  3609.        Description: Pause for up to 999 seconds.
  3610.  
  3611.        Example:
  3612.  
  3613.           {pause 25}          Pause for 25 seconds.
  3614.  
  3615.        NOTE:  Incoming characters displayed during a PAUSe function are not
  3616.        seen by subsequent GOLOok/LOOKfor functions.
  3617.  
  3618.  
  3619.        POPStack
  3620.        --------
  3621.        Default key: none
  3622.        Description: Pop an element from the macro stack.
  3623.  
  3624.        Example:
  3625.  
  3626.           {pops}              No arguments.
  3627.  
  3628.  
  3629.  
  3630.                    {COMMO} (tm)  User Guide and Reference           page 62
  3631.  
  3632.  
  3633.        POPStack throws away the top element on the macro stack.  This
  3634.        element would have been the target of the next RETUrn function.
  3635.  
  3636.        See PUSHstack for a more complete description of the use of this
  3637.        function.
  3638.  
  3639.        See also CALL, RETUrn, GOLOok, LOOKfor.
  3640.  
  3641.  
  3642.        PRINtlog
  3643.        --------
  3644.        Default key: Alt-2
  3645.        Description: Set Print Log toggle.
  3646.  
  3647.        Examples:
  3648.  
  3649.           {print}             Toggle Print Log on/off.
  3650.           {print y}           Turn on Print Log.
  3651.           {print n}           Turn off Print Log.
  3652.  
  3653.  
  3654.        PUSHstack
  3655.        ---------
  3656.        Default key: none
  3657.        Description: Push a return point onto the macro stack.
  3658.  
  3659.        Examples:
  3660.  
  3661.           {push}              Push the current location.
  3662.           {push abc}          Push the location "abc".
  3663.  
  3664.        When there are no arguments, the location pushed is the location of
  3665.        the PUSHstack function itself (i.e., it will be executed again when
  3666.        a RETUrn is encountered).
  3667.  
  3668.        Explanation:  Whenever a CALL is executed, the location of the
  3669.        function following the CALL (the "return point") is "pushed" onto
  3670.        the macro stack.  When a subsequent RETUrn is executed, the location
  3671.        at the top of the stack is "popped" and control is transferred to
  3672.        that location.  This allows "nesting" of CALLs and RETUrns.
  3673.  
  3674.        PUSHstack will push a return point onto the macro stack without
  3675.        transferring control to the location (control continues in
  3676.        sequence).  A subsequent RETUrn will transfer control to the
  3677.        location that was pushed.
  3678.  
  3679.        POPStack will remove the top stack element without transferring
  3680.        control to it (control continues in sequence).
  3681.  
  3682.        These functions may be used to set a return point for GOLOok/LOOKfor
  3683.        functions, so that the same GOLOok routines may be used in more than
  3684.        one macro.  They also help to create macros with improved structure.
  3685.  
  3686.  
  3687.  
  3688.                    {COMMO} (tm)  User Guide and Reference           page 63
  3689.  
  3690.  
  3691.  
  3692.        Here is a sample construct using PUSHstack and POPStack:
  3693.  
  3694.           {mmm} {call ggg} ...
  3695.            ...
  3696.           {ggg} ...
  3697.                 {pushstack}
  3698.                 {golook aaa,string1}
  3699.                 {golook bbb,string2}
  3700.                 {golook ccc,string3}
  3701.                 {lookfor string4} {send answer4}
  3702.                 {popstack} {return}
  3703.  
  3704.           {aaa} {send answer1} {return}
  3705.           {bbb} {send answer2} {return}
  3706.           {ccc} {send answer3} {return}
  3707.  
  3708.        If strings 1,2 or 3 come in, responses will be sent and control will
  3709.        RETUrn to the PUSHstack (and execute it again).  If string 4 comes
  3710.        in the element pushed will be discarded by the POPStack and control
  3711.        will return following the {call ggg}.
  3712.  
  3713.        See also CALL, RETUrn, GOLOok, LOOKfor.
  3714.  
  3715.  
  3716.        RETUrn
  3717.        ------
  3718.        Default key: none
  3719.        Description: Return from a CALLed macro.
  3720.  
  3721.        Example:
  3722.  
  3723.           {return}            No arguments.
  3724.  
  3725.        This function will return control to a location determined by the
  3726.        last CALL or PUSHstack function.  See PUSHstack for a more complete
  3727.        description of the use of CALL/RETUrn.
  3728.  
  3729.        Note: If a RETUrn is encountered and no CALL or PUSHstack has been
  3730.        executed, a STOP will occur.  This is useful in macros that are
  3731.        CALLed and are also used standalone (such as protocol file transfer
  3732.        macros).
  3733.  
  3734.        See also CALL, PUSHstack, POPStack.
  3735.  
  3736.  
  3737.        SCREen
  3738.        ------
  3739.        Default key: Alt-I
  3740.        Description: Screen Image Save.
  3741.  
  3742.        Examples:
  3743.  
  3744.  
  3745.  
  3746.                    {COMMO} (tm)  User Guide and Reference           page 64
  3747.  
  3748.  
  3749.  
  3750.           {screen}                 Open Screen Image Save window.
  3751.           {screen y}               Append screen image to current file.
  3752.           {screen y,commo.scn}     Append screen image to indicated file.
  3753.                                    (and change current pathname).
  3754.           {screen n,c:\file.xyz}   Change current screen image pathname
  3755.                                    (don't save screen to file).
  3756.  
  3757.  
  3758.        SCROllback
  3759.        ----------
  3760.        Default key: Alt-K
  3761.        Description: Display Scrollback Buffer
  3762.  
  3763.        Example:
  3764.  
  3765.           {scroll}            No arguments.
  3766.  
  3767.  
  3768.        SEND
  3769.        ----
  3770.        Default key: none
  3771.        Description: Send a string to the modem.
  3772.  
  3773.        Examples:
  3774.  
  3775.           {send Fred|~~Brucker|~~#|}    Send my first and last name with
  3776.                                         carriage returns and 1 second
  3777.                                         delays, then send the current
  3778.                                         password and a <cr>.
  3779.  
  3780.           {send ^[^[}                   Send two <esc> characters.
  3781.  
  3782.        Note: see Appendix D "ASCII Character Representation" for
  3783.        information on how to represent any character in a SEND function.
  3784.  
  3785.  
  3786.        SETLook
  3787.        -------
  3788.        Default key: none
  3789.        Description: Set parameters for LOOKfor functions.
  3790.  
  3791.        Example:
  3792.  
  3793.           {setl 60,abc,4,n|}       Set LOOKfor parameters
  3794.  
  3795.        60      LOOKfor timeout.  Maximum time in seconds to look for a
  3796.                string.  If the string is not found in the allotted time,
  3797.                the macro in the second argument will be started.  May be 0
  3798.                to 999.  "0" means forever.  
  3799.  
  3800.  
  3801.  
  3802.                    {COMMO} (tm)  User Guide and Reference           page 65
  3803.  
  3804.  
  3805.        abc     Timeout macro.  Macro to GOTO if the time in the first
  3806.                argument expires.  If no macro is specified or if the
  3807.                macro-id is invalid, control will pass to the function
  3808.                following the LOOKfor.
  3809.  
  3810.        4       Prompt timeout.  During a LOOKfor function unwanted prompts
  3811.                may appear like "Press any key" or "More [Y/n]", etc.  This
  3812.                argument is the time in seconds to wait at a prompt (no
  3813.                input from the modem) before sending the string in the
  3814.                fourth argument.  Usually you would send "|" or "n|".
  3815.  
  3816.                When the string is sent the process is restarted, allowing
  3817.                any number of prompts to be satisfied (until the LOOKfor
  3818.                itself is satisfied or times out).
  3819.  
  3820.                The timer will also be reset if any keys are typed while
  3821.                waiting.  This allows a manual response to a prompt which
  3822.                the macro does not handle.
  3823.  
  3824.                Make sure this value is high enough to give the host system
  3825.                time to "think" when it is in between prompts.  Some systems
  3826.                take longer to do things.  May be 0 to 999.  "0" means
  3827.                forever.
  3828.  
  3829.        n|      Prompt response.  String to send when the time in the third
  3830.                argument runs out.  May be up to 32 characters.
  3831.  
  3832.        The SETLook function will set parameters for all subsequent LOOKfor
  3833.        functions.  It may be executed at any time to modify the parameters. 
  3834.        When macro processing terminates, the parameters will be reset to
  3835.        the default values.
  3836.  
  3837.        Default arguments are:      LOOKfor timeout     0 (forever)
  3838.                                    Timeout macro       none 
  3839.                                    Prompt timeout      0 (forever)
  3840.                                    Prompt response     none
  3841.  
  3842.        Null arguments in the SETLook function will revert to these
  3843.        defaults.
  3844.  
  3845.        See also: LOOKfor, GOLOok.
  3846.  
  3847.  
  3848.        SHELl
  3849.        -----
  3850.        Default key: Alt-S
  3851.        Description: Shell to DOS.
  3852.  
  3853.        Example:
  3854.  
  3855.           {shell}             No arguments.
  3856.  
  3857.  
  3858.  
  3859.                    {COMMO} (tm)  User Guide and Reference           page 66
  3860.  
  3861.  
  3862.  
  3863.        SOUNd
  3864.        -----
  3865.        Default key: Alt-3
  3866.        Description: Set Master Sound toggle.
  3867.  
  3868.        Examples:
  3869.  
  3870.           {sound}             Toggle Master Sound on/off.
  3871.           {sound y}           Turn on Master Sound.
  3872.           {sound n}           Turn off Master Sound.
  3873.  
  3874.  
  3875.        STATusline
  3876.        ----------
  3877.        Default key: none
  3878.        Description: Set Status Line toggle.
  3879.  
  3880.        IMPORTANT!  The Status Line is {COMMO}'s instrument panel.  You
  3881.        should not turn it off until you are familiar with operating the
  3882.        program.
  3883.  
  3884.        Examples:
  3885.  
  3886.           {statusline}        Toggle Status Line on/off.
  3887.           {status y}          Turn on Status Line.
  3888.           {status n}          Turn off Status Line.
  3889.  
  3890.        When the Status Line is off (not visible), the bottom line of the
  3891.        display becomes part of the Terminal Screen.
  3892.  
  3893.        The STATusline function is ignored while in Chat Mode.
  3894.  
  3895.  
  3896.        STOP
  3897.        ----
  3898.        Default key: none
  3899.        Description: Halt macro execution.
  3900.  
  3901.        Examples:
  3902.  
  3903.           {stop}              No arguments.
  3904.           {}                  Short form.
  3905.  
  3906.        STOP always returns {COMMO} to manual operation in the Terminal
  3907.        Screen.  It should be used to end login macros.
  3908.  
  3909.  
  3910.        TERMinal
  3911.        --------
  3912.        Default key: none
  3913.        Description: Set Terminal Emulation Type.
  3914.  
  3915.  
  3916.  
  3917.                    {COMMO} (tm)  User Guide and Reference           page 67
  3918.  
  3919.  
  3920.  
  3921.        Example:
  3922.  
  3923.           {terminal V}        Set VT102 emulation.
  3924.           {term a}            Set ANSI-BBS emulation.
  3925.           {term t}            Set TTY emulation.
  3926.  
  3927.  
  3928.        UNMArk
  3929.        ------
  3930.        Default key: none
  3931.        Description: Unmark Dialing Directory entries.
  3932.  
  3933.        Example:
  3934.  
  3935.           {unmark joes-bbs,file-city}        Unmark listed entries.
  3936.           {unmark}                           Unmark all entries.
  3937.  
  3938.        See the description of the MARK function for the rules on writing
  3939.        macro Dialing Strings.
  3940.  
  3941.        See also: DIAL, MARK.
  3942.  
  3943.  
  3944.        VTCUr
  3945.        -----
  3946.        Default key: none
  3947.        Description: Define a VT102 cursor (arrow) key.
  3948.  
  3949.        Example:
  3950.  
  3951.           {vtcur ^[[A|^[OA}        Define up-arrow key strings.
  3952.  
  3953.        The first string is sent when cursor mode is active; the second
  3954.        string is sent when application mode is active (these modes are
  3955.        controlled by the host).
  3956.  
  3957.        The two strings must be separated by a "|".  Use "^m" for carriage
  3958.        return if necessary.
  3959.  
  3960.        See also VTPAd.
  3961.  
  3962.  
  3963.        VTPAd
  3964.        -----
  3965.        Default key: none
  3966.        Description: Define a VT102 keypad key.
  3967.  
  3968.        Example:
  3969.  
  3970.           {vtpad 5|^[Ou}           Define keypad "5" key strings.
  3971.  
  3972.  
  3973.  
  3974.                    {COMMO} (tm)  User Guide and Reference           page 68
  3975.  
  3976.  
  3977.        The first string is sent when numeric mode is active; the second
  3978.        string is sent when application mode is active (these modes are
  3979.        controlled by the host).
  3980.  
  3981.        The two strings must be separated by a "|".  Use "^m" for carriage
  3982.        return if necessary.
  3983.  
  3984.        See also VTCUr.
  3985.  
  3986.  
  3987.        =========================
  3988.        Table of {COMMO} Key-id's
  3989.        =========================
  3990.  
  3991.        Key-id's are also macro-id's with the added advantage that the macro
  3992.        can be started by pressing the associated key from the Terminal
  3993.        Screen.  Most "extended" keys may be assigned this way.  If the same
  3994.        key-id appears more than once, the first occurrence will be used. 
  3995.        Note that key-id's are case insensitive.  The caret (^) indicates
  3996.        the Ctrl key.
  3997.  
  3998.        Enhanced keyboard key-id's are listed below.
  3999.  
  4000.  
  4001.                Key Name     Key-id        Key Name     Key-id
  4002.                ________     ______        ________     ______
  4003.  
  4004.                Normal-F1     nf1   ...    Normal-F10    nf0
  4005.                Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  4006.                Shift-F1      sf1   ...    Shift-F10     sf0
  4007.                Alt-F1        af1   ...    Alt-F10       af0
  4008.  
  4009.                Alt-A         ala   ...    Alt-Z         alz
  4010.                Alt-1         al1   ...    Alt-0         al0
  4011.                Alt =         al=          Alt -         al-
  4012.  
  4013.                Escape        esc          Grey *        gr*
  4014.                Grey -        gr-          Grey +        gr+
  4015.  
  4016.                Backspace     bsp          ^Backspace    cbs
  4017.                Tab           tab          Shift-tab     stb
  4018.                Enter         ent          ^Enter        cen
  4019.  
  4020.                Home          hom          End           end
  4021.                PgUp          pgu          PgDn          pgd
  4022.                Up-Arrow      upa          Down-Arrow    dna
  4023.                Left-Arrow    lfa          Right-Arrow   rta
  4024.                Insert        ins          Delete        del
  4025.  
  4026.                ^Home         chm          ^End          cnd
  4027.                ^PgUp         cpu          ^PgDn         cpd
  4028.                ^Right-Arrow  cra          ^Left-Arrow   cla
  4029.  
  4030.  
  4031.  
  4032.                    {COMMO} (tm)  User Guide and Reference           page 69
  4033.  
  4034.  
  4035.  
  4036.                Keypad-0      kp0   ...    Keypad-9      kp9
  4037.                Keypad-.      kp.          ^PrtSc        cpr
  4038.  
  4039.  
  4040.        Enhanced Keyboard Key-id's
  4041.        ==========================
  4042.  
  4043.                Normal-F11    nfa          Normal-F12    nfb
  4044.                Ctrl-F11      cfa          Ctrl-F12      cfb
  4045.                Shift-F11     sfa          Shift-F12     sfb
  4046.                Alt-F11       afa          Alt-F12       afb
  4047.  
  4048.                Alt-[         al[          Alt-]         al]
  4049.                Alt-;         al;          Alt-'         al'
  4050.                Alt-,         al<          Alt-.         al.
  4051.                Alt-/         al/          Alt-\         al\
  4052.                Alt-*         al*          Alt-`         al`
  4053.                Center Key    cky
  4054.  
  4055.        The Center Key is the Keypad 5 with Numlock off.
  4056.  
  4057.        The keys in the second group may also work with the 83-key keyboard
  4058.        if your BIOS supports the enhanced keyboard.  Try them (the enhanced
  4059.        keyboard must first be enabled in the Configuration File).
  4060.  
  4061.  
  4062.        ==========   =====================
  4063.        Appendix A   Setting Up Your Modem
  4064.        ==========   =====================
  4065.  
  4066.        Please be aware that there are many different modems in use and that
  4067.        it is of the utmost importance that you configure your modem to work
  4068.        correctly with {COMMO}.  A few tips will be given here, but they are
  4069.        no substitute for the detailed installation instructions in your
  4070.        modem manual!
  4071.  
  4072.        When {COMMO} is started, a command string called the Modem
  4073.        Initialization String will be sent to the modem.  You must make
  4074.        certain that you have the correct string in your Configuration File. 
  4075.        This string will perform part or all of the modem setup depending on
  4076.        the type of modem.  Examples will be given for the most common
  4077.        types.
  4078.  
  4079.        If your modem is external to your computer, be sure you have
  4080.        followed the installation instructions carefully and that the cable
  4081.        is connected to the computer's serial port.  It is wise to turn off
  4082.        power to the computer and the modem when connecting or disconnecting
  4083.        any cables.
  4084.  
  4085.        Also check Item 1 in the Configuration File -- the Serial Port
  4086.        Parameters.  This string consists of the default speed, data format
  4087.  
  4088.  
  4089.  
  4090.                    {COMMO} (tm)  User Guide and Reference           page 70
  4091.  
  4092.  
  4093.        and port number.  For example if you usually use your modem at 2400
  4094.        bps, data format 8n1, on Com1, your parameter string would be:
  4095.  
  4096.           {2400,8n1,1}
  4097.  
  4098.           _______________
  4099.  
  4100.           1200 bps Modems
  4101.           _______________
  4102.  
  4103.        Most 1200 bps modems have switches on them which must be set to
  4104.        provide the proper interaction with your computer and with {COMMO}. 
  4105.        Consult your modem manual concerning these switches and pay
  4106.        particular attention to the following:
  4107.  
  4108.           1)   Enable command recognition.  Allows the modem to recognize
  4109.                commands (dial, set registers, etc.).  Must be in the
  4110.                "enable" position or modem will be unusable.
  4111.  
  4112.           2)   Send result codes in English.  This switch should be set so
  4113.                that the modem will send verbal responses to commands
  4114.                instead of numbers.  This is usually controlled by a command
  4115.                also (such as ATV1).
  4116.  
  4117.           3)   Respond to DTR (data terminal ready).  This should NOT be in
  4118.                the "ignore" or "on all the time" position.  This switch
  4119.                allows the computer to signal the modem to hang up.
  4120.  
  4121.           4)   Respond to carrier detect or "allow true carrier."  This
  4122.                should NOT be set to the "on all the time" position.
  4123.  
  4124.        Here is an example Modem Initialization String which will set up a
  4125.        1200 bps modem and override the switch settings (if possible):
  4126.  
  4127.           {~AT S0=0 S7=60 E0 Q0 V1 X1 |}
  4128.  
  4129.        The most important command to check is the "X" command, since its
  4130.        function varies the most from modem to modem.  The "X" command
  4131.        determines which responses the modem will generate during dialing
  4132.        (e.g. CONNECT, BUSY, etc.).  It may also activate an additional
  4133.        modem feature such as automatic redialing which will interfere with
  4134.        {COMMO}'s own redialing procedure.
  4135.  
  4136.        Your modem manual gives a description for each level of the "X"
  4137.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  4138.        highest level that does not activate undesirable features.  If you
  4139.        will be using {COMMO}'s AutoBaud feature you will need the extended
  4140.        connect responses such as CONNECT 1200.  Also the BUSY response
  4141.        should be provided if possible.  In any case you should modify the
  4142.        Modem Initialization String to work with your particular modem.
  4143.  
  4144.  
  4145.  
  4146.                    {COMMO} (tm)  User Guide and Reference           page 71
  4147.  
  4148.  
  4149.           ___________________
  4150.  
  4151.           2400 bps and higher
  4152.           ___________________
  4153.  
  4154.        Modems which operate at 2400 bps and higher generally have commands
  4155.        to replace the switches (see the section above if yours has
  4156.        switches).  These commands may be given every time you start {COMMO}
  4157.        or they may be permanently remembered by modems which have "non-
  4158.        volatile" memory.
  4159.  
  4160.        It will be assumed here that the commands are given every time you
  4161.        start {COMMO}.  If you wish to place the settings in non-volatile
  4162.        memory, consult your modem manual on how to do this.  Here is an
  4163.        example Modem Initialization String for most 2400 bps modems:
  4164.  
  4165.           {~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  4166.  
  4167.        See the comments above concerning the "X" command since they apply
  4168.        to these modems as well.
  4169.  
  4170.        IMPORTANT!  Many modems that operate at 2400 bps and above require
  4171.        additional commands to control features such as data compression and
  4172.        error checking.  Consult the modem manual for details.
  4173.  
  4174.  
  4175.        If {COMMO} is already running you may edit the Configuration File
  4176.        with the Alt-G key command, change the Modem Initialization String,
  4177.        then use the Alt-O key command to send the string to the modem. 
  4178.        Normally the string is sent to the modem when {COMMO} is started.
  4179.  
  4180.  
  4181.        Answering a call from another computer
  4182.        ======================================
  4183.  
  4184.        There are two easy ways to use {COMMO} to answer when a friend or
  4185.        associate calls you by computer.  For best results, make sure you
  4186.        are in Chat Mode.  Press Alt-- (Alt minus) to enter/exit Chat Mode.
  4187.  
  4188.        1) While in Chat Mode or in the Terminal Screen, wait for the phone
  4189.           to ring, then type "ATA<cr>" (upper case is not necessary with
  4190.           many modems).  Your modem should answer immediately (go off hook)
  4191.           and begin handshaking with the remote modem.
  4192.  
  4193.           When you see the CONNECT message you are ready to communicate. 
  4194.           At this point you can type, send data with macro keys, send a
  4195.           text file with ASCII Upload or send any file with an external
  4196.           protocol.
  4197.  
  4198.           You can use a macro key to send the answer command to the modem. 
  4199.           For example, to send it by pressing Alt-W, place the following
  4200.           macro in your Macro File.  When the phone rings, press Alt-W.
  4201.  
  4202.  
  4203.  
  4204.                    {COMMO} (tm)  User Guide and Reference           page 72
  4205.  
  4206.  
  4207.  
  4208.                {alw} {send ATA|} {}     Answer the phone!
  4209.  
  4210.        2) The other method involves setting your modem into Auto Answer
  4211.           Mode.  This method is useful in some situations, but will cause
  4212.           the modem to answer whenever the phone rings.  This can be
  4213.           undesirable if you get a voice call.
  4214.  
  4215.           To set Auto Answer just type "ATS0=1<cr>" (or make "S0=1" part of
  4216.           your Modem Initialization String).  This will tell the modem to
  4217.           answer on ring "1" (adjust to as many rings as desired).  To turn
  4218.           off Auto Answer type "ATS0=0<cr>".  These may also be sent with
  4219.           macro keys. 
  4220.  
  4221.  
  4222.        Connecting two computers (null modem cable)
  4223.        ===========================================
  4224.  
  4225.        {COMMO} may be used on a "direct connection" between two computers
  4226.        or between a computer and another serial device.  Connect the two
  4227.        serial ports with a "null modem" cable.  Then start the program on
  4228.        each computer, having selected the appropriate serial port
  4229.        parameters in the Configuration File(s).
  4230.  
  4231.        The null modem cable should be designed so that the transmit line on
  4232.        each end connects to the receive line on the other end.  No other
  4233.        signals are needed, but none of the RS-232C signals should be left
  4234.        "floating."  They should be tied high or low (or at least grounded).
  4235.  
  4236.        You may have to disable the Usage Log in the Configuration File by
  4237.        setting the path to null {}.  The log is triggered by changes in
  4238.        Carrier Detect and will slow things down if CD is unpredictable.
  4239.  
  4240.  
  4241.        ==========   =========================
  4242.        Appendix B   {COMMO} and Multi-Tasking
  4243.        ==========   =========================
  4244.  
  4245.           ________
  4246.  
  4247.           DESQview
  4248.           ________
  4249.  
  4250.        Special care has been taken to ensure that {COMMO} is compatible
  4251.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  4252.        supervisor.  DESQview allows more than one program to execute at the
  4253.        same time.
  4254.  
  4255.        A sample Program Information File (CO-PIF.DVP) has been included in
  4256.        the {COMMO} package for your convenience.  This file is installed as
  4257.        follows:
  4258.  
  4259.  
  4260.  
  4261.                    {COMMO} (tm)  User Guide and Reference           page 73
  4262.  
  4263.  
  4264.           1)   Copy the file to your DESQview directory (usually C:\DV).
  4265.           2)   Run "Add a Program" (AP) from the "Open Window" menu.
  4266.           3)   Select "Other."  Specify the DESQview directory as the
  4267.                "Path."
  4268.           4)   Mark the {COMMO} entry, press Enter.  "CO" should now appear
  4269.                on your "Open Window" menu.
  4270.  
  4271.        The CO-PIF.DVP file has been set up to define a 150k memory window. 
  4272.        The amount of memory actually required is affected by the size of
  4273.        your COMMO.FON file, your COMMO.MAC file and the size of your
  4274.        Scrollback buffer.
  4275.  
  4276.        Test the size of the window by running DSZ, LIST, etc., from the
  4277.        Macro Processor or Shell to DOS.  Be sure to test the execution of
  4278.        external programs with a "wait" at the end so that you can see any
  4279.        error messages (see EXEC function).
  4280.  
  4281.        CO-PIF.DVP can be changed with the "Change a Program" (CP) command
  4282.        on the "Open Window" menu.  You may also want to change the
  4283.        directory information or other parameters.
  4284.  
  4285.        TIPS on using {COMMO} with DESQview:
  4286.  
  4287.        1) For best performance the foreground and background "tick counts"
  4288.           should both be 10 or less.  This is particularly important in
  4289.           order for Auto Receive to function properly.
  4290.  
  4291.        2) If you switch to another task, do not attempt to access any files
  4292.           which may be in use in the {COMMO} window.  Examples are the
  4293.           Capture File, the Screen Image File and files that may be
  4294.           currently involved in a file transfer (upload or download).  The
  4295.           result may be a loss of part or all of the data in the file. 
  4296.           This is a general DESQview no-no.  You may freely access these
  4297.           files in the Shell to DOS or Macro Processor features of {COMMO}
  4298.           (within the same window).
  4299.  
  4300.        3) If the memory allocated to the window is too small, {COMMO} will
  4301.           not be able to load the Online Help file.  Since the Online Help
  4302.           file is loaded only when requested, you needn't be concerned if
  4303.           you don't intend to use it.
  4304.  
  4305.        4) The video display may seem less smooth in DESQview.  This is a
  4306.           result of {COMMO} using the fastest possible display method, and
  4307.           is quite normal.  This effect can be reduced by specifying fewer
  4308.           clock ticks for foreground and background (4 and 4 seems to work
  4309.           well). 
  4310.  
  4311.        5) The Snow Checking option should not be used when {COMMO} is run
  4312.           under DESQview.  If you see "snow" type interference in your CGA
  4313.           display, use DESQview's own snow checking (request "synchronized
  4314.           access" in the Setup program).
  4315.  
  4316.  
  4317.  
  4318.                    {COMMO} (tm)  User Guide and Reference           page 74
  4319.  
  4320.  
  4321.           ________
  4322.  
  4323.           OmniView
  4324.           ________
  4325.  
  4326.        Display bleed-through may be avoided by telling OmniView that
  4327.        {COMMO} "Supports TopView Functions" or by using the "/T" switch on
  4328.        the OmniView command line.
  4329.  
  4330.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  4331.        most of which apply to OmniView as well.
  4332.  
  4333.           _________
  4334.  
  4335.           DoubleDOS
  4336.           _________
  4337.  
  4338.        Color displays require the "DISPLAY = TEXT" option in DDCONFIG.SYS. 
  4339.        Run {COMMO} in the bottom partition -- about 130k to 150k should
  4340.        suffice if you plan to use Online Help and/or external protocols. 
  4341.        Increase this size in proportion to the size of your Scrollback
  4342.        buffer.
  4343.  
  4344.        Some non-multi-tasker-aware, direct-screen-writing programs executed
  4345.        with the Macro Processor or Shell to DOS may not display properly. 
  4346.        If this happens you may have to run {COMMO} in the top partition.
  4347.  
  4348.        Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS for
  4349.        running other programs in this partition ({COMMO} doesn't use it).
  4350.  
  4351.        With this setup you may run any non-graphics program in the top
  4352.        partition, including direct screen writers.  
  4353.  
  4354.        Monochrome displays require the REFRESH option in DDCONFIG.SYS. 
  4355.        Refer to the DoubleDOS user's manual for information on this.
  4356.  
  4357.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  4358.        most of which apply to DoubleDOS as well.
  4359.  
  4360.  
  4361.  
  4362.                    {COMMO} (tm)  User Guide and Reference           page 75
  4363.  
  4364.  
  4365.        ==========   ============
  4366.        Appendix C   Flow Control
  4367.        ==========   ============
  4368.  
  4369.        Flow Control is a signalling system used by communications devices
  4370.        to prevent data from being transmitted faster than it can be
  4371.        processed by the receiving system.  This is especially important
  4372.        when data is transferred at high speeds.
  4373.  
  4374.        Flow Control is activated from the Configuration File and is used by
  4375.        {COMMO} for both sending and receiving.  You may specify Software
  4376.        Flow Control, Hardware Flow Control or both.  Changes may be made at
  4377.        any time using the Internal Editor and will be effective immediately
  4378.        upon exiting the editor.
  4379.         
  4380.        Software Flow Control uses a control character called XOFF (or ^S)
  4381.        to signal the remote to pause.  XON (^Q) is the signal to "resume
  4382.        transmission."  This is normally used only for ASCII data, since
  4383.        these characters may appear randomly within binary data.  An XOFF
  4384.        pause will automatically be released in 20 seconds if no XON is
  4385.        received.  It will also be released if you type a character in the
  4386.        Terminal Screen.
  4387.  
  4388.        Hardware Flow Control uses the RTS/CTS lines in your RS-232C (serial
  4389.        port) cable to signal pause/resume without interfering with the
  4390.        data.  It should only be used when you are connected to a device
  4391.        which also recognizes RTS/CTS Flow Control (such as a high-speed
  4392.        modem or another computer connected with a null modem cable).  A
  4393.        CTS-off (send) pause will not be released automatically.  Turn off
  4394.        Hardware Flow Control (in the Configuration File) if you need to
  4395.        override it.
  4396.  
  4397.        TIPS on using Flow Control:
  4398.  
  4399.        1) Your modem must be properly initialized to utilize flow control
  4400.           (consult the manual for details).
  4401.  
  4402.        2) Since Software Flow Control uses the XOFF (ASCII 19) and XON
  4403.           (ASCII 17) characters, these will not display on the screen.  If
  4404.           it is necessary to display them, Software Flow Control must be
  4405.           turned off.
  4406.  
  4407.        3) It is especially important to use Flow Control when the Print Log
  4408.           is on, since data is usually received faster than it can be
  4409.           printed.  If you type a character to the remote during a flow
  4410.           control pause, the remote may begin sending again (some systems
  4411.           resume on any character, not just XON).  You may have to turn off
  4412.           the Print Log if this happens.
  4413.  
  4414.  
  4415.  
  4416.                    {COMMO} (tm)  User Guide and Reference           page 76
  4417.  
  4418.  
  4419.        ==========   ==============================
  4420.        Appendix D   ASCII Character Representation
  4421.        ==========   ==============================
  4422.  
  4423.        Sometimes it is necessary to enter control characters and other
  4424.        special characters in the {COMMO} support files or as input to
  4425.        {COMMO} key commands.
  4426.  
  4427.        For example, a carriage return (typed with the Enter key) is used to
  4428.        terminate your typed input.  Therefore a carriage return must be
  4429.        represented by some other character (or characters) in order to be
  4430.        used as data.
  4431.  
  4432.        Data strings are used in many places in the {COMMO} support files.
  4433.        Some examples are:
  4434.  
  4435.           Modem initialization string        (Config. File)
  4436.           Dial prefixes                      (Config. File)
  4437.           Dial suffix                        (Config. File)
  4438.           Telephone number                   (Dialing Directory)
  4439.           Password string                    (Dialing Directory)
  4440.           Strings in macro functions such as
  4441.                SEND, SETLook and LOOKfor     (Macro File)
  4442.  
  4443.        Here is a list of some of the most common control characters and how
  4444.        to represent them.  Notice the caret (^) symbol.  It is the shift
  4445.        character above the top row "6".
  4446.  
  4447.           Carriage return          ^M or |
  4448.           Linefeed                 ^J
  4449.           Formfeed                 ^L
  4450.           Escape                   ^[
  4451.           Bell                     ^G
  4452.           XOFF                     ^S
  4453.           XON                      ^Q
  4454.           End of file              ^Z
  4455.  
  4456.        Some characters have special significance in data strings:
  4457.  
  4458.           The vertical bar (|) represents a carriage return.
  4459.  
  4460.           The tilde (~) forces a one-half second delay in strings sent to
  4461.           the modem.  In other strings it is just a tilde.
  4462.  
  4463.           The pound sign (#) will cause the current Password String to be
  4464.           sent when it is used in the SEND function.  In other strings it
  4465.           is just a pound sign.
  4466.  
  4467.        Now you are probably asking, "How do I send a tilde?  Or a pound
  4468.        sign?"  These and other special characters may be sent by preceding
  4469.        them with a caret (^):
  4470.  
  4471.  
  4472.  
  4473.                    {COMMO} (tm)  User Guide and Reference           page 77
  4474.  
  4475.  
  4476.           Vertical bar             ^|
  4477.           Tilde                    ^~
  4478.           Pound sign               ^#
  4479.           Caret                    ^^
  4480.           Left curly brace         ^(
  4481.           Right curly brace        ^)
  4482.  
  4483.        Please notice that parentheses are used to represent curly braces.
  4484.        Curly braces are very special characters and may not be used as data
  4485.        in the support files.
  4486.  
  4487.        Every character in the extended ASCII chart may be represented.  The
  4488.        caret (^) is used to represent the following ASCII values (decimal):
  4489.  
  4490.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  4491.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  4492.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  4493.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  4494.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  4495.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  4496.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  4497.  
  4498.        ASCII 28 to 31 and those in the extended graphic character set (128
  4499.        to 255), may be typed using the ALT-NUMERIC-KEYPAD method as
  4500.        follows:
  4501.  
  4502.           1.   Hold down the Alt key (and keep it down).
  4503.           2.   Enter the ASCII code in decimal using the numeric keypad
  4504.                keys (1, 2 or 3 digits are ok).
  4505.           3.   Release the Alt key.
  4506.  
  4507.  
  4508.        ==========   ==================
  4509.        Appendix E   Terminal Emulation
  4510.        ==========   ==================
  4511.  
  4512.        Terminal Emulation Type is indicated on the status line (to the
  4513.        right of the Serial Port Parameters string).  Available types are:
  4514.  
  4515.                A   ANSI-BBS   Used on bulletin boards and other systems.
  4516.                V   VT102      Used on minicomputers and mainframes.
  4517.                T   TTY        Supports only the basic control characters.
  4518.  
  4519.        The default Terminal Emulation Type (as defined in the Configuration
  4520.        File) will be set whenever a system is dialed.  It may be changed
  4521.        temporarily using the Alt-L key command or the TERMinal macro
  4522.        function.
  4523.  
  4524.        TIPS on using terminal emulation:
  4525.  
  4526.        1) Whenever a change is made, a reset of mode parameters will be
  4527.           performed.  It is therefore important that the change be made
  4528.  
  4529.  
  4530.  
  4531.                    {COMMO} (tm)  User Guide and Reference           page 78
  4532.  
  4533.  
  4534.           BEFORE (or at the time of) connecting with a host (mode settings
  4535.           may be transmitted by the host).
  4536.  
  4537.        2) If some screens do not look right when VT102 emulation is used,
  4538.           you may need to turn LINEWRAP off (it defaults to on).
  4539.  
  4540.        3) Linewrap may be turned on/off locally using the DISPlay macro
  4541.           function.  Place one of the following in your login macro (or
  4542.           assign one of them to a key and execute it manually):
  4543.  
  4544.                     {display ,,,^[[?7h}      linewrap ON
  4545.                     {display ,,,^[[?7l}      linewrap OFF
  4546.  
  4547.        4) If colors do not always look right, it may be necessary to set
  4548.           the Terminal Screen colors in the Configuration File to {07}. 
  4549.           See the note under "Colors" in the Configuration File section.
  4550.  
  4551.  
  4552.        Printer Support
  4553.        ===============
  4554.  
  4555.        {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  4556.        remote system.
  4557.  
  4558.           The "Printer ON/OFF" function will turn {COMMO}'s Print Log
  4559.           ON/OFF.
  4560.  
  4561.           The "Dedicated Printing" function will send all input from the
  4562.           serial port directly to the printer.  This allows for
  4563.           "transparent" transmission of printer data, including control
  4564.           codes.
  4565.  
  4566.           The "Print Screen" function will print the entire current screen.
  4567.  
  4568.        The printer should be on and ready to print when these functions are
  4569.        used.  When "Dedicated Printing" is active no characters will be
  4570.        displayed on the screen.
  4571.  
  4572.  
  4573.        ANSI-BBS Keyboard Support
  4574.        =========================
  4575.  
  4576.        The sample Macro File is set up so you can use the PC keypad keys
  4577.        (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.
  4578.  
  4579.  
  4580.  
  4581.                    {COMMO} (tm)  User Guide and Reference           page 79
  4582.  
  4583.  
  4584.        VT102 Keyboard Simulation
  4585.        =========================
  4586.  
  4587.        Two keyboard files, VT102-1.MAC and VT102-2.MAC, provide support to
  4588.        simulate the VT102 keyboard.  You may merge one of these into
  4589.        COMMO.MAC if you intend to use VT102 all the time (replace the ANSI-
  4590.        BBS keys).  Be sure that you have no conflicting key-id's (remember
  4591.        that {COMMO} will use the first occurrence of a key-id).
  4592.  
  4593.        Or you can use the MACLoad function in your login macro to load the
  4594.        VT102 file automatically when you connect to the host.  Using the
  4595.        "r" option of MACLoad will reload COMMO.MAC at disconnect.  For
  4596.        example:
  4597.  
  4598.           {macload vt102-1.mac,,r}
  4599.  
  4600.        Both files support the following PC keypad functions (^ indicates
  4601.        the Ctrl key):
  4602.  
  4603.                Four cursor (arrow) keys
  4604.                Home   - Home cursor
  4605.                ^Home  - Insert line
  4606.                PgUp   - Page up
  4607.                ^PgUp  - Delete line
  4608.                PgDn   - Page down
  4609.                ^PgDn  - Clear screen
  4610.                End    - End of line
  4611.                Ins    - Insert mode
  4612.                Del    - Delete
  4613.                ^bs   -  Ctrl backspace (delete)
  4614.  
  4615.        VT102 numeric keypad keys are auto-switched by the host system
  4616.        between numeric mode and application mode.
  4617.  
  4618.        The four cursor keys are auto-switched between cursor mode and
  4619.        application mode.
  4620.  
  4621.        These files may be modified to create any keyboard support you
  4622.        desire (see description of VTCUr and VTPAd functions in the section
  4623.        "{COMMO} Macro Functions."
  4624.  
  4625.           ___________
  4626.  
  4627.           VT102-1.MAC
  4628.           ___________
  4629.  
  4630.        This file contains keyboard assignments that work best with the
  4631.        enhanced keyboard (because of the separate cursor keys, etc.).
  4632.  
  4633.        With Numlock ON the ten digits and period will simulate their
  4634.        equivalent VT102 functions.  In addition:
  4635.  
  4636.  
  4637.  
  4638.                    {COMMO} (tm)  User Guide and Reference           page 80
  4639.  
  4640.  
  4641.                F1 to F4 simulate PF1 to PF4
  4642.                Grey * is used for comma
  4643.                Grey - is used for dash
  4644.                Grey + is used for Enter
  4645.  
  4646.           ___________
  4647.  
  4648.           VT102-2.MAC
  4649.           ___________
  4650.  
  4651.        This file contains keyboard assignments that work best with the 83-
  4652.        key keyboard (because of the location of the function keys on the
  4653.        left side).
  4654.  
  4655.        The following diagram shows how the ten function keys (Fn) and ten
  4656.        shifted function keys (SFn) relate to the VT102 keypad keys:
  4657.  
  4658.  
  4659.                F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  4660.  
  4661.                F3=   7     F4=   8     SF3=   9     SF4=   -
  4662.  
  4663.                F5=   4     F6=   5     SF5=   6     SF6=   ,
  4664.         
  4665.                F7=   1     F8=   2     SF7=   3     SF8=   Enter
  4666.  
  4667.                F9=   0     F10=  0     SF9=   .     SF10=  Enter
  4668.  
  4669.  
  4670.        ==========   ==========================
  4671.        Appendix F   Error Message Explanations
  4672.        ==========   ==========================
  4673.  
  4674.        If you get an error message that you don't understand, check below
  4675.        for additional information.
  4676.  
  4677.        __________________________
  4678.  
  4679.        Wrong number of braces { }
  4680.        __________________________
  4681.  
  4682.           The Configuration File does not have the correct number of
  4683.           strings (items), or the left and right curly braces are not
  4684.           present in matched pairs.  If necessary compare the file with the
  4685.           original one in the {COMMO} package.
  4686.  
  4687.           If you get this message at program startup, check your "SET
  4688.           COMMO=" command in your AUTOEXEC.BAT file.  It may be specifying
  4689.           a directory that has an old version of COMMO.CFG.
  4690.  
  4691.  
  4692.  
  4693.                    {COMMO} (tm)  User Guide and Reference           page 81
  4694.  
  4695.  
  4696.        ________________________________
  4697.  
  4698.        Sorry, out of memory
  4699.        Not enough memory for Scrollback
  4700.        ________________________________
  4701.  
  4702.           These messages may occur at program startup.  Check the
  4703.           following:
  4704.  
  4705.           1)   {COMMO} cannot allocate its internal buffers.  You must make
  4706.                more memory available.
  4707.  
  4708.           2)   {COMMO} cannot load the Dialing Directory and/or Macro File. 
  4709.                Try reducing the size of either of these files.  Removing
  4710.                comments may help.  Or make more memory available.
  4711.  
  4712.           3)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its
  4713.                size or make more memory available.
  4714.  
  4715.        _______________________________
  4716.  
  4717.        Cannot locate command processor
  4718.        _______________________________
  4719.  
  4720.           This is an unusual condition.  Type "SET" at the DOS prompt and
  4721.           be sure there is a "COMSPEC=" in the list.  If there is, make
  4722.           sure that COMMAND.COM is in the path specified.
  4723.  
  4724.        _______________________________   
  4725.  
  4726.        Check your "SET COMMO=" command
  4727.        _______________________________
  4728.  
  4729.           1)   The Configuration File cannot be located or it has the wrong
  4730.                number of braces.  Make sure your "SET COMMO=" points to the
  4731.                correct disk/directory.
  4732.  
  4733.           2)   The path located in the system environment is too long.  Do
  4734.                another "SET COMMO=" command to correct this.
  4735.  
  4736.        ___________________________________________
  4737.  
  4738.        WARNING: another copy of {COMMO} is running
  4739.        ___________________________________________
  4740.  
  4741.        This message lets you know that you have at least one other copy of
  4742.        {COMMO} resident in your computer.  Usually this happens when you
  4743.        Shell to DOS from {COMMO}, then run {COMMO} again.  
  4744.  
  4745.        If possible you should exit back to the first copy to avoid losing
  4746.        changes to your support files.
  4747.  
  4748.  
  4749.  
  4750.                    {COMMO} (tm)  User Guide and Reference           page 82
  4751.  
  4752.  
  4753.        _______________________
  4754.  
  4755.        Not enough memory
  4756.        Program file not found
  4757.        Unable to execute shell
  4758.        _______________________
  4759.  
  4760.           A problem was encountered during Shell to DOS, EXEC, EXEN or
  4761.           EXED:
  4762.  
  4763.           1)   There may not be enough memory to execute the command
  4764.                processor or external program you have specified.
  4765.  
  4766.           2)   The program file you specified in an EXED function cannot be
  4767.                located.  Make sure you specify the full path and filename.
  4768.  
  4769.           3)   Some other system error condition may exist.  Make sure that
  4770.                COMMAND.COM is still available in the "COMSPEC=" path.
  4771.  
  4772.        ___________________________
  4773.  
  4774.        Hardware flow control pause
  4775.        ___________________________
  4776.  
  4777.           Hardware Flow Control is in effect and the remote system (or your
  4778.           modem) has requested a pause.  Try waiting a few seconds for the
  4779.           pause to clear; if that fails you may have to turn off Hardware
  4780.           Flow Control (in the Configuration File).
  4781.  
  4782.        _________________________________________
  4783.  
  4784.        File space full!  Delete unnecessary text
  4785.        _________________________________________
  4786.  
  4787.           {COMMO} allows about 65,000 bytes when editing any file (the
  4788.           Dialing Directory and Macro File occupy a common file space). 
  4789.           This limit may be reached when editing any of the files with the
  4790.           Internal Editor.  If this happens you must reduce the size of the
  4791.           file in question.  Try removing comment lines and any other
  4792.           extraneous information.
  4793.  
  4794.           This message may also be the result of loading a resident program
  4795.           (TSR) in the Shell to DOS or via the EXEC macro function.  Other
  4796.           causes involve a corruption of DOS parameters and require
  4797.           rebooting.
  4798.  
  4799.  
  4800.  
  4801.                    {COMMO} (tm)  User Guide and Reference           page 83
  4802.  
  4803.  
  4804.        _____________________
  4805.  
  4806.        Dial command too long
  4807.        _____________________
  4808.  
  4809.           The dial command consists of the dial prefix, the phone number
  4810.           string and the dial suffix.  The total is limited to 72
  4811.           characters.
  4812.  
  4813.        _______________________
  4814.  
  4815.        Bad parameter after "%"
  4816.        _______________________
  4817.  
  4818.           Allowable parameters are listed in the description of the "EXEC"
  4819.           macro function.
  4820.  
  4821.        ________________________
  4822.  
  4823.        Command too long for DOS
  4824.        ________________________
  4825.  
  4826.           DOS commands are limited to 127 characters.
  4827.  
  4828.        ________________________________
  4829.  
  4830.        Unable to open file
  4831.        Unable to open Help File
  4832.        Unable to open Capture File
  4833.        Unable to open Screen Image File
  4834.        File not found
  4835.        Path not found
  4836.        Too many files
  4837.        ________________________________
  4838.  
  4839.           Check the following:
  4840.  
  4841.           1)   That the path exists where the file should be.
  4842.           2)   That the file itself exists (this won't be the problem if
  4843.                the file is being created).
  4844.           3)   Too many files may be open.  You may need to increase your
  4845.                FILES= parameter in CONFIG.SYS.
  4846.           4)   The Online Help File must be less than 64K bytes in size.
  4847.           5)   You cannot use an open Capture File for any other purpose.
  4848.  
  4849.  
  4850.  
  4851.                    {COMMO} (tm)  User Guide and Reference           page 84
  4852.  
  4853.  
  4854.        _____________________________________
  4855.  
  4856.        Closing Capture File, disk is full!
  4857.        Screen Image not saved, disk is full!
  4858.        _____________________________________
  4859.  
  4860.           These files should be edited regularly to ensure that they are
  4861.           not occupying too much disk space.
  4862.  
  4863.  
  4864.                                    - end -
  4865.  
  4866.